Migrar o Application Live View para o Administrador Gerenciado para o Spring nos Aplicativos de Contêiner do Azure

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 como migrar o Portal de API para o Administrador Gerenciado para Spring nos Aplicativos de Contêiner do Azure.

O componente gerenciado Administrador do Spring fornece uma interface administrativa para aplicativos web do Spring Boot que expõe os pontos de extremidade de atuador. É semelhante ao Application Live View, atuando como uma ferramenta leve de insights e solução de problemas para ajudar desenvolvedores e operadores a monitorar aplicativos em execução.

Pré-requisitos

• Uma instância configurada do plano Enterprise dos Aplicativos Spring do Azure já provisionada com o Serviço de Configuração de Aplicativos habilitado.
• Um Aplicativo de Contêiner do Azure existente. Para obter mais informações, confira Guia de Início Rápido: implantar seu primeiro aplicativo de contêiner usando o portal do Azure.
• CLI do Azure.

Provisionar o Administrador Gerenciado para Spring em Aplicativos de Contêiner do Azure

Use as seguintes etapas para provisionar o componente:

Portal do Azure

1. Navegue até seu ambiente de aplicativo de contêiner no portal do Azure.

2. Em Serviços no menu de serviço, selecione Serviços.

3. Escolha Configurar e selecione componente Java.

4. Preencha o painel Configurar componente Java com os seguintes valores:

   Propriedade	Valor
   Tipo de componente Java	Administrador do Spring
   Nome do componente Java	admin

5. Selecione Avançar.

6. Na guia Revisão, selecione Configurar.

CLI do Azure

1. Use o seguinte comando para criar o componente Administrador para Spring Java:

   az containerapp env java-component admin-for-spring create \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
       --environment $ENVIRONMENT \
       --min-replicas 1 \
       --max-replicas 1
   

2. Use o seguinte comando para atualizar o componente Administrador para Spring Java:

   az containerapp env java-component admin-for-spring update \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
       --environment $ENVIRONMENT \
       --min-replicas 2 \
       --max-replicas 2
   

Atualizar a dependência do aplicativo de contêiner

Para integrar o componente de administrador ao seu aplicativo de contêiner, adicione a seguinte dependência ao arquivo pom.xml. Substitua o número de versão pela versão mais recente disponível no Repositório do Maven.

<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-starter-client</artifactId>
    <version>3.3.2</version>
</dependency>

Associe seu aplicativo contêiner ao componente Administrador do Spring Java

Portal do Azure

Use as seguintes etapas para associar seu aplicativo de contêiner ao componente:

1. Ir para o ambiente de aplicativos de contêiner no portal do Azure.
2. Em Serviços, selecione Serviços.
3. Na lista, escolha administrador.
4. Em Associações, selecione o nome do aplicativo de contêiner na lista suspensa Nome do aplicativo.
5. Selecione a guia Examinar e, em seguida, selecione Configurar.
6. Navegue até seu aplicativo de contêiner no portal do Azure e copie sua URL para uso posterior.

CLI do Azure

Use o seguinte comando para criar o aplicativo de contêiner e associá-lo ao componente Administrador para Spring:

az containerapp create \
    --resource-group $RESOURCE_GROUP \
    --name $APP_NAME \
    --environment $ENVIRONMENT \
    --image $IMAGE \
    --min-replicas 1 \
    --max-replicas 1 \
    --ingress external \
    --target-port 8080 \
    --bind $JAVA_COMPONENT_NAME

Acessar o painel de administração

Observação

O Administrador Gerenciado para Spring nos Aplicativos de Contêiner do Azure não dá suporte à configuração de SSO (logon único). Ele depende de atribuições de função do Azure.

Para acessar o painel, você deve ter a função Microsoft.App/managedEnvironments/write atribuída à sua conta para o recurso de ambiente gerenciado.

Criar e atribuir uma função personalizada

Use as seguintes etapas para criar e atribuir uma função personalizada:

1. Use o seguinte comando para criar uma definição de função personalizada:

   az role definition create --role-definition '{
       "Name": "<ROLE_NAME>",
       "IsCustom": true,
       "Description": "Access to managed Java Component dashboards in managed environments",
       "Actions": [
          "Microsoft.App/managedEnvironments/write"
       ],
       "AssignableScopes": ["/subscriptions/<SUBSCRIPTION_ID>"]
   }'
   

2. use o seguinte comando para atribuir a função personalizada à sua conta:

   az role assignment create \
       --assignee <USER_OR_SERVICE_PRINCIPAL_ID> \
       --role "<ROLE_NAME>" \
       --scope $ENVIRONMENT_ID