Migración de la vista activa de la aplicación al administrador de Spring Boot

Artículo
02/05/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 la ruta de migración de Application Live View al administrador de Spring Boot.

El administrador de Spring Boot es una herramienta eficaz para administrar y supervisar aplicaciones de Spring Boot. Basado en los accionadores de Spring Boot, proporciona información sobre el funcionamiento interno de las aplicaciones en ejecución a través de puntos de conexión HTTP accesibles. El administrador de Spring Boot recopila datos y facilita la interacción con las aplicaciones mediante estos puntos de conexión.

Configuración del servidor de administración de Spring Boot

Anteriormente, Azure Spring Apps proporcionaba integración integrada con Tanzu Application Live View para ayudarle a administrar las aplicaciones. Sin embargo, debido a los cambios en las características del producto, esta funcionalidad ya no está disponible. Para asegurarse de que puede seguir administrando fácilmente las aplicaciones, los pasos siguientes le guían a través de la configuración y el uso de la Spring Boot Admin Server como solución alternativa:

Crear una nueva aplicación.
- Azure Portal
- CLI de Azure
Siga estos pasos para crear una aplicación de Spring Boot Admin Server:
1. Vaya a la instancia empresarial de Azure Spring Apps en Azure Portal.
2. En el panel de navegación, abra el panel Aplicaciones para ver las aplicaciones de la instancia de servicio.
3. Seleccione Crear aplicaciones para abrir el panel Crear aplicación.
4. Asigne a la aplicación el nombre spring-boot-admin.
5. Deje Tipo de implementación como Artefactos de (Java/Polyglot) sin cambios.
6. Abra lista desplegable Enlazar y seleccione Registro de servicio.
7. Seleccione Crear para crear la aplicación.
Use el siguiente comando para crear una aplicación Spring Boot Admin Server:
```
az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name spring-boot-admin \
    --bind-service-registry
```

Compile el servicio de administración de Spring Boot.

Después de crear la aplicación, el siguiente paso es compilar la aplicación de servicio de administración de Spring Boot. Siga las instrucciones de la documentación de introducción del administrador de Spring Boot.

Puede hacer referencia al código de ejemplo siguiente:

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

Agregue las siguientes dependencias de administrador de 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>

Implemente la aplicación.

Después de compilar el servicio de administración de Spring Boot, impleméntelo mediante la CLI de 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

Asigne un punto de conexión público.

Haga que el servidor de administración de Spring Boot sea accesible mediante la asignación de un punto de conexión público a través de Azure Spring Apps.

El administrador de Spring Boot no incluye la autorización de forma predeterminada. El administrador de Spring Boot es una aplicación de Spring Boot normal, por lo que puede protegerla con seguridad de spring. Consulte también Protección del servidor de administración de Spring Boot.

Registro de aplicaciones en el administrador de Spring Boot

Uso del servicio de detección

El administrador de Spring Boot puede detectar aplicaciones basándose en el servicio de detección. Una vez registradas las aplicaciones con el Registro de servicio de Tanzu, el servidor de administración de Spring Boot los reconoce automáticamente.

Para obtener más información sobre cómo registrar aplicaciones con el Registro de servicio de Tanzu, consulte Uso de Tanzu Service Registry.

El administrador de Spring Boot se conecta sin problemas a las aplicaciones de Spring Boot y supervisa las aplicaciones de Spring Boot que tienen la configuración personalizada del accionador.

Uso de un cliente de administrador de Spring Boot

También puede registrar aplicaciones como clientes de administración de Spring Boot. Este enfoque no depende de un servicio de detección, pero requiere modificar las aplicaciones para incluir dependencias de cliente de administración de Spring Boot. Para obtener más información, consulte Introducción en la documentación del administrador de Spring Boot.

Uso del administrador de Spring Boot para supervisar las aplicaciones

El administrador de Spring Boot le permite ver las métricas dinámicas de las aplicaciones de Spring Boot. El Administrador de Spring Boot se basa en el concepto de accionadores de Spring Boot.

Siga estos pasos para implementar una aplicación y supervisarla en el administrador de Spring Boot:

Agregue la dependencia del accionador. Agregue la siguiente dependencia al archivo pom.xml de la aplicación.

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

Habilite los puntos de conexión del accionador. En el archivo application.properties de la aplicación, agregue la siguiente configuración para exponer los puntos de conexión necesarios:
```
management.endpoints.web.exposure.include=info,health
```
Compile la aplicación. Use el siguiente comando para compilar la aplicación localmente:
```
mvn clean package -DskipTests
```

Implemente la aplicación. Implemente la aplicación en Azure Spring Apps mediante los siguientes 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

Deshabilitar la Vista en vivo de la aplicación

Una vez registradas todas las aplicaciones de Spring Boot en el administrador de Spring Boot, puede deshabilitar la característica Application Live View en Azure Spring Apps siguiendo estos pasos:

Azure Portal
CLI de Azure

Vaya a la instancia del servicio Azure Spring Apps y, después, seleccione Herramientas de desarrollo.
Seleccione Administrar herramientas.
Desactive la casilla Habilitar Vista en vivo de la aplicación y, a continuación, seleccione Guardar.
A continuación, puede ver el estado de Application Live View en las Herramientas de desarrollo.

Use el siguiente comando para deshabilitar Application Live View:

az spring application-live-view delete
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

Restricciones conocidas

Si registra aplicaciones con el Registro de servicios, la aplicación EUREKA-SERVER aparece en el panel administrador de Spring Boot con un estado de SIN CONEXIÓN y no se puede ocultar ni quitar.
De forma predeterminada, no se admite el inicio de sesión único (SSO).

Compartir vía