Migrar a Visualização ao Vivo do Aplicativo para o Managed Admin for Spring em Aplicativos de Contêiner do Azure

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 como migrar o Portal de API para o Managed Admin for Spring em Aplicativos de Contêiner do Azure.

O componente gerenciado Admin for Spring fornece uma interface administrativa para aplicativos Web Spring Boot que expõem pontos de extremidade atuadores. É 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 de plano do Azure Spring Apps Enterprise configurada com o Serviço de Configuração de Aplicativo habilitado.
• Um aplicativo de contêiner do Azure existente. Para obter mais informações, veja o Início Rápido: implementar a primeira aplicação de contentor com o portal do Azure.
• CLI do Azure.

Provisionar o administrador gerenciado para o Spring em aplicativos de contêiner do Azure

Use as seguintes etapas para provisionar o componente:

Portal do Azure

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

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

3. Escolha Configurar e, em seguida, selecione Componente Java.

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

   Property	valor
   Tipo de componente Java	Admin para a primavera
   Nome do componente Java	administrador

5. Selecione Seguinte.

6. Na guia Revisão, selecione Configurar.

CLI do Azure

1. Use o seguinte comando para criar o componente Admin for 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 Admin for 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 Admin ao seu aplicativo de contêiner, adicione a seguinte dependência ao seu arquivo pom.xml . Substitua o número da versão pela versão mais recente do repositório Maven.

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

Vincular seu aplicativo de contêiner ao componente Admin for Spring Java

Portal do Azure

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

1. Vá para o ambiente do seu aplicativo de contêiner no portal do Azure.
2. Em Serviços, selecione Serviços.
3. Na lista, escolha admin.
4. Em Ligações, selecione o nome do aplicativo contêiner na lista suspensa Nome do aplicativo .
5. Selecione a guia Revisão 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 vinculá-lo ao componente Admin for 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

Acesse o painel de administração

Nota

O Managed Admin for Spring nos Aplicativos de Contêiner do Azure não oferece suporte à configuração de logon único (SSO). Ele depende de atribuições de função do Azure.

Para acessar o painel, você deve ter a Microsoft.App/managedEnvironments/write função 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