Migración de la aplicación Vista en vivo al administrador gestionado para Spring en Azure Container Apps

Artículo
02/06/2025

Nota:

Los planes de Básico, Estándar y Enterprise quedarán en desuso a partir de mediados de marzo de 2025, con un período de retiro de 3 años. Se recomienda realizar la transición a Azure Container Apps. Para más información, consulte el anuncio de retirada de Azure Spring Apps.

El plan de consumo estándar y dedicado quedará obsoleto a partir del 30 de septiembre de 2024, con un cierre completo al cabo de seis meses. Se recomienda realizar la transición a Azure Container Apps. Para obtener más información, consulte Migrar el plan de consumo y dedicado Azure Spring Apps Standard a Azure Container Apps.

Este artículo se aplica a: ❎ Básico/Estándar ✅ Enterprise

En este artículo se describe cómo migrar el Portal de API al Administrador gestionado para Spring en Azure Container Apps.

El componente gestionado Administrador para Spring ofrece una interfaz administrativa para las aplicaciones web de Spring Boot que exponen puntos de conexión de actuadores. Es similar a la aplicación Vista en vivo, que actúa como una herramienta ligera de información y solución de problemas para ayudar a los desarrolladores y operadores a supervisar las aplicaciones en ejecución.

Requisitos previos

Una instancia configurada del plan Enterprise de Azure Spring Apps con el Servicio de configuración de aplicaciones habilitado.
Una aplicación del contenedor de Azure existente. Para obtener más información, consulte Inicio rápido: implementación de la primera aplicación contenedora mediante Azure Portal.
Azure CLI.

Aprovisionamiento del administrador gestionado para Spring en Azure Container Apps

Siga estos pasos para aprovisionar el componente:

Azure Portal
CLI de Azure

Vaya al entorno de la aplicación de contenedor en Azure Portal.
En el menú servicio, en Servicios, seleccione Servicios.
Elija Configurary, después, seleccione Componente de Java.
Rellene el panel Configurar componentes de Java con los siguientes valores:

Propiedad Valor

Tipo de componente de Java Administrador para Spring

Nombre del componente de Java admin
Seleccione Siguiente.
En la pestaña Revisar, seleccione Configurar.

Propiedad	Valor
Tipo de componente de Java	Administrador para Spring
Nombre del componente de Java	admin

Use el siguiente comando para crear el 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

Use el siguiente comando para actualizar el 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

Actualización de la dependencia de la aplicación de contenedor

Para integrar el componente Administrador en la aplicación contenedora, agregue la siguiente dependencia al archivo pom.xml. Reemplace el número de versión por la última versión disponible en el Repositorio de Maven.

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

Enlace de su aplicación contenedora con el componente de Java Administrador para Spring

Azure Portal
CLI de Azure

Siga estos pasos para enlazar la aplicación contenedora al componente:

Vaya al entorno de la aplicación contenedora en Azure Portal.
En Servicios, seleccione Servicios.
En la lista, elija administrador.
En Enlaces, seleccione el nombre de la aplicación contenedora en el Nombre de aplicación.
Seleccione la pestaña Revisar y, después, seleccione Configurar.
Vaya a la aplicación contenedora en Azure Portal y copie su dirección URL para su uso posterior.

Use el siguiente comando para crear la aplicación contenedora y enlazarla al componente de 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

Acceso al panel de administración

Nota:

El Administrador gestionado para Spring de Azure Container Apps no admite la configuración de inicio de sesión único (SSO). Se basa en las asignaciones de roles de Azure.

Para acceder al panel, debe tener asignado el rol Microsoft.App/managedEnvironments/write a su cuenta para el recurso de entorno administrado.

Crear y asignar un rol personalizado

Siga estos pasos para crear y asignar un rol personalizado:

Use el comando siguiente para crear una definición de roles 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>"]
}'

Use el siguiente comando para asignar el rol personalizado a su cuenta:

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

Compartir vía