Migrar o Live View do aplicativo para o Spring Boot Admin

Artigo
02/04/2025

Nota

Os planos Basic, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de aposentadoria de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

O plano de consumo padrão e dedicado será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte Migrar consumo padrão e plano dedicado do Azure Spring Apps para Aplicativos de Contêiner do Azure.

Este artigo aplica-se a: ❎ Basic/Standard ✅ Enterprise

Este artigo descreve o caminho de migração do Application Live View para o Spring Boot Admin.

O Spring Boot Admin é uma ferramenta poderosa para gerenciar e monitorar aplicativos Spring Boot. Construído em atuadores de inicialização Spring, ele fornece informações sobre o funcionamento interno de aplicativos em execução por meio de pontos de extremidade HTTP acessíveis. O Spring Boot Admin reúne dados e facilita a interação com seus aplicativos usando esses endpoints.

Configurar o Spring Boot Admin Server

O Azure Spring Apps forneceu anteriormente integração interna com o Tanzu Application Live View para ajudá-lo a gerenciar seus aplicativos. No entanto, devido a alterações nos recursos do produto, essa funcionalidade não está mais disponível. Para garantir que você possa continuar a gerenciar facilmente seus aplicativos, as etapas a seguir o guiam pela configuração e uso do Spring Boot Admin Server como uma solução alternativa:

Criar uma nova aplicação.
- Portal do Azure
- CLI do Azure
Use as seguintes etapas para criar um aplicativo Spring Boot Admin Server:
1. Navegue até sua instância corporativa do Azure Spring Apps no portal do Azure.
2. No painel de navegação, abra o painel Aplicativos para exibir aplicativos para sua instância de serviço.
3. Selecione Criar aplicativo para abrir o painel Criar aplicativo .
4. Nomeie o aplicativo spring-boot-admin.
5. Deixe o tipo de implementação como Artefatos (Java/Poliglota) inalterado.
6. Abra a lista suspensa Bind e selecione Service Registry.
7. Selecione Criar para criar o aplicativo.
Use o seguinte comando para criar um aplicativo Spring Boot Admin Server:
```
az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name spring-boot-admin \
    --bind-service-registry
```

Crie o serviço de administração do Spring Boot.

Depois de criar o aplicativo, a próxima etapa é criar o aplicativo de serviço Spring Boot Admin. Siga as instruções na documentação de Introdução do Spring Boot Admin.

Você pode fazer referência ao seguinte código de exemplo:

SpringBootAdminApplication.java

@SpringBootApplication
@Configuration
@EnableAutoConfiguration // Use a discovery service instead of Spring Boot Admin Clinet. The rest is done by our AutoConfiguration.
@EnableDiscoveryClient  // Enables the service to register with a discovery service
@EnableAdminServer
public class SpringBootAdminApplication {
  public static void main(String[] args) {
     SpringApplication.run(SpringBootAdminApplication.class, args);
  }
}

pom.xml

Adicione as seguintes dependências do Spring Boot Admin:

<!-- Spring Boot Admin -->
<dependency>
  <groupId>de.codecentric</groupId>
  <artifactId>spring-boot-admin-starter-server</artifactId>
  <version>${spring-boot-admin.version}</version>
</dependency>
<dependency>
  <groupId>de.codecentric</groupId>
  <artifactId>spring-boot-admin-server-ui</artifactId>
  <version>${spring-boot-admin.version}</version>
</dependency>

Implante o aplicativo.

Depois de criar o serviço Spring Boot Admin, implante-o usando a CLI do Azure:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name spring-boot-admin \
    --source-path

Atribua um ponto de extremidade público.

Torne o servidor Spring Boot Admin acessível atribuindo um ponto de extremidade público por meio do Azure Spring Apps.

O Spring Boot Admin não inclui autorização por padrão. O Spring Boot Admin é um aplicativo Spring Boot normal, para que você possa protegê-lo com segurança de mola. Consulte também Protegendo o Spring Boot Admin Server.

Registrar aplicativos no Spring Boot Admin

Usar o serviço de descoberta

O Spring Boot Admin pode descobrir aplicativos confiando no serviço de descoberta. Depois que os aplicativos são registrados no Tanzu Service Registry, o servidor Spring Boot Admin os reconhece automaticamente.

Para obter mais informações sobre como registrar aplicativos com o Tanzu Service Registry, consulte Usar o Tanzu Service Registry.

O Spring Boot Admin se conecta e monitora perfeitamente os aplicativos do Spring Boot que têm configurações de atuador personalizadas.

Usar um cliente de administração do Spring Boot

Você também pode registrar aplicativos como Spring Boot Admin Clients. Essa abordagem não depende de um serviço de descoberta, mas requer a modificação de seus aplicativos para incluir dependências do Spring Boot Admin Client. Para obter mais informações, consulte Introdução na documentação do Spring Boot Admin.

Use o Spring Boot Admin para monitorar seus aplicativos

O Spring Boot Admin permite visualizar métricas em tempo real para aplicativos Spring Boot. Spring Boot Admin é baseado no conceito de Spring Boot Actuators.

Siga estas etapas para implantar um aplicativo e monitorá-lo no Spring Boot Admin:

Adicione a dependência do atuador. Adicione a seguinte dependência ao arquivo de pom.xml do seu aplicativo.

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
 </dependency>

Habilite os pontos finais do atuador. No arquivo application.properties do seu aplicativo, adicione a seguinte configuração para expor os pontos de extremidade necessários:
```
management.endpoints.web.exposure.include=info,health
```
Criar a aplicação. Use o seguinte comando para criar seu aplicativo localmente:
```
mvn clean package -DskipTests
```

Implemente a aplicação. Implante o aplicativo no Azure Spring Apps usando os seguintes comandos:

az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name>
cd <path-to-maven-or-gradle-source-root>
az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name> \
    --source-path

Desativar o aplicativo Live View

Depois que todos os aplicativos Spring Boot forem registrados no Spring Boot Admin, você poderá desabilitar o recurso Application Live View no Azure Spring Apps seguindo estas etapas:

Portal do Azure
CLI do Azure

Navegue até sua instância de serviço do Azure Spring Apps e selecione Ferramentas de Desenvolvedor.
Selecione Gerenciar ferramentas.
Desmarque a caixa de seleção Ativar visualização dinâmica do aplicativo e selecione Salvar.
Em seguida, você pode exibir o estado do Application Live View nas Ferramentas de Desenvolvedor.

Use o seguinte comando para desativar o Application Live View:

az spring application-live-view delete
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

Limitações conhecidas

Se você registrar aplicativos com o Service Registry, o aplicativo EUREKA-SERVER aparecerá no painel Admin do Spring Boot com um status OFFLINE e não poderá ser oculto ou removido.
Por padrão, o logon único (SSO) não é suportado.

Partilhar via