Partilhar via


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, Standarde Enterprise entraram em um período de aposentadoria em 17 de março de 2025. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

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 gerido Admin for Spring fornece uma interface administrativa para aplicações web Spring Boot que expõem endpoints de 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

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

Use as seguintes etapas para provisionar o componente:

  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:

    Propriedade valor
    Tipo de componente Java Admin para Spring
    Nome do componente Java administrador
  5. Selecione Seguinte.

  6. Na guia Revisão, selecione Configurar.

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

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.

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