Migrar o Application Live View para o Administrador do Spring Boot

Artigo
02/05/2025

Observação

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

O plano consumo e dedicado Standard 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 mais informações, confira Migrar o plano dedicado e consumo Standard dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.

Este artigo se aplica a: ❎ Básico/Padrão ✅ Enterprise

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

O Administrador do Spring Boot é uma ferramenta poderosa para gerenciar e monitorar aplicativos do Spring Boot. Criado com base em Atuadores do Spring Boot, ele fornece insights sobre o funcionamento interno dos aplicativos em execução por meio de pontos de extremidade HTTP acessíveis. O Administrador do Spring Boot coleta dados e facilita a interação com seus aplicativos usando esses pontos de extremidade.

Configurar o Servidor do Administrador do Spring Boot

Os Aplicativos Spring do Azure forneceu anteriormente uma integração interna com o Tanzu Application Live View para ajudar você 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 orientarão você na configuração e no uso do Servidor do Administrador do Spring Boot como uma solução alternativa:

Crie um novo aplicativo.
- Portal do Azure
- CLI do Azure
Use as seguintes etapas para criar um aplicativo do Servidor do Administrador do Spring Boot:
1. Navegue até sua instância corporativa dos Aplicativos Spring do Azure 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 implantação como Artefatos (Java/Polyglot) inalterado.
6. Abra o menu suspenso Associar e selecione Registro de Serviço.
7. Selecione Criar para criar o aplicativo.
Use o seguinte comando para criar um aplicativo do Servidor do Administrador do Spring Boot:
```
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 do Administrador do Spring Boot.

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

Você pode referenciar o 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 Administrador do Spring Boot:

<!-- 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 do Administrador do Spring Boot, 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 do Administrador do Spring Boot acessível atribuindo um ponto de extremidade público por meio dos Aplicativos Spring do Azure.

O Administrador do Spring Boot não inclui autorização por padrão. O Administrador do Spring Boot é um aplicativo Spring Boot normal, portanto, você pode protegê-lo com a segurança do Spring. Confira também Proteção do Servidor do Administrador do Spring Boot.

Registrar aplicativos no Administrador do Spring Boot

Usar o serviço de descoberta

O Administrador do Spring Boot pode descobrir aplicativos contando com o serviço de descoberta. Depois que os aplicativos são registrados no Registro de Serviço do Tanzu, o servidor do Administrador do Spring Boot os reconhece automaticamente.

Para obter mais informações sobre como registrar aplicativos no Registro de Serviço do Tanzu, confira Usar o Registro de Serviço do Tanzu.

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

Usar um Cliente Administrador do Spring Boot

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

Usar o Administrador do Spring Boot para monitorar seus aplicativos

O Administrador do Spring Boot permite exibir métricas dinâmicas para aplicativos do Spring Boot. O Administrador do Spring Boot baseia-se no conceito de Atuadores do Spring Boot.

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

Adicione a dependência do atuador. Adicione a dependência a seguir ao arquivo pom.xml do aplicativo.

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

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

Implantar o aplicativo. Implante o aplicativo nos Aplicativos Spring do Azure 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

Desabilitar o Aplicativo Live View

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

Portal do Azure
CLI do Azure

Navegue até sua instância de serviço dos Aplicativos Spring do Azure e selecione Ferramentas de Desenvolvedor.
Selecione Gerenciar Ferramentas.
Marque a caixa de seleção Habilitar o App Live View e selecione Salvar.
Em seguida, você pode visualizar o estado da Exibição ao Vivo de Aplicativos nas Ferramentas para Desenvolvedores.

Use o seguinte comando para desabilitar 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 Registro de Serviço, o aplicativo EUREKA-SERVER aparecerá no painel do Administrador do Spring Boot com um status OFFLINE e ele não poderá ser oculto ou removido.
Por padrão, não há suporte para SSO (logon único).

Compartilhar via