Share via

Tutorial: Uso de la configuración dinámica en una aplicación de Java Spring

  • Artículo

App Configuration tiene dos bibliotecas para Spring.

  • spring-cloud-azure-appconfiguration-config requiere Spring Boot y tiene una dependencia de spring-cloud-context.
  • spring-cloud-azure-appconfiguration-config-web requiere Spring Web junto con Spring Boot y también agrega compatibilidad para la comprobación automática de la actualización de configuración.

Ambas bibliotecas admiten el desencadenamiento manual para comprobar los valores de configuración actualizados.

La actualización permite actualizar los valores de configuración sin tener que reiniciar la aplicación, aunque hará que se vuelvan a crear todas los beans de @RefreshScope. Comprueba si hay cambios en los desencadenadores configurados, incluidos los metadatos. De manera predeterminada, la cantidad mínima de tiempo entre las comprobaciones de cambios, el intervalo de actualización, se establece en 30 segundos.

La actualización automatizada de spring-cloud-azure-appconfiguration-config-web se desencadena en función de la actividad, específicamente de ServletRequestHandledEvent de Spring Web. Si no se desencadena un evento ServletRequestHandledEvent, la actualización automatizada de spring-cloud-azure-appconfiguration-config-web no desencadena una actualización aunque haya expirado la fecha de expiración de la caché.

Uso de la actualización manual

Para usar la actualización manual, comience con una aplicación de Spring Boot que usa App Configuration, como la aplicación que se crea siguiendo las indicaciones del inicio rápido de Spring Boot con App Configuration.

App Configuration expone AppConfigurationRefresh que se puede usar para comprobar si la memoria caché ha expirado y, si ha expirado, se desencadena una actualización.

  1. Actualice HelloController para usar AppConfigurationRefresh.

    import com.azure.spring.cloud.config.AppConfigurationRefresh;

@RestController
public class HelloController {
    private final MessageProperties properties;

    @Autowired(required = false)
    private AppConfigurationRefresh refresh;

    public HelloController(MessageProperties properties) {
        this.properties = properties;
    }

    @GetMapping
    public String getMessage() throws InterruptedException, ExecutionException {
        if (refresh != null) {
            refresh.refreshConfigurations();
        }
        return "Message: " + properties.getMessage();
    }
}

    refreshConfigurations() de AppConfigurationRefresh devuelve un valor de Mono que es true si se ha desencadenado una actualización y false en caso contrario. False significa que el tiempo de expiración de la caché no ha expirado, no se ha producido ningún cambio u otro subproceso está comprobando actualmente una actualización.

  2. Actualización de bootstrap.properties para habilitar las métricas

    spring.cloud.azure.appconfiguration.stores[0].monitoring.enabled=true
spring.cloud.azure.appconfiguration.stores[0].monitoring.refresh-interval= 30s
spring.cloud.azure.appconfiguration.stores[0].monitoring.triggers[0].key=sentinel

  3. Abra Azure Portal y vaya al recurso de App Configuration asociado a la aplicación. Seleccione Explorador de configuración en Operaciones y, después, + Crear>Par clave-valor para crear un par clave-valor y agregar los parámetros siguientes:

    Clave Value
    centinela 1

    Deje Etiqueta y Tipo de contenido en blanco, por ahora.

  4. Seleccione Aplicar.

  5. Compile la aplicación de Spring Boot con Maven y ejecútela.

    mvn clean package
mvn spring-boot:run

  6. Abra una ventana del explorador y vaya a la dirección URL: http://localhost:8080. Verá el mensaje asociado con la clave.

    También puede usar curl para probar la aplicación, por ejemplo:

    curl -X GET http://localhost:8080/

  7. Para probar la configuración dinámica, abra el portal de Azure App Configuration asociado a la aplicación. Seleccione Explorador de configuración y actualice el valor de la clave que se muestra, por ejemplo:

    Clave Value
    /application/config.message Hello: actualizado

  8. Actualice a un nuevo valor la clave de Sentinel que ha creado antes. Este cambio hace que la aplicación actualice todas las claves de configuración una vez que haya transcurrido el intervalo de actualización.

    Clave Value
    centinela 2

  9. Actualice la página del explorador dos veces para ver el nuevo mensaje que se muestra. La primera vez desencadena la actualización, la segunda carga los cambios.

Nota

La biblioteca solo comprueba los cambios una vez transcurrido el intervalo de actualización, si no se ha pasado el período, no se verá ningún cambio, tendrá que esperar a que pase el período y, a continuación, desencadenar la comprobación de actualización.

Uso de la actualización automatizada

Para usar la actualización automatizada, comience con una aplicación de Spring Boot que usa App Configuration, como la aplicación que se crea siguiendo las indicaciones del inicio rápido de Spring Boot con App Configuration.

Después, abra el archivo pom.xml en un editor de texto y agregue <dependency> para spring-cloud-azure-appconfiguration-config-web mediante el código siguiente.

Spring Boot

<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-appconfiguration-config-web</artifactId>
    <version>5.8.0</version>
</dependency>

  1. Actualización de bootstrap.properties para habilitar las métricas

    spring.cloud.azure.appconfiguration.stores[0].monitoring.enabled=true
spring.cloud.azure.appconfiguration.stores[0].monitoring.refresh-interval= 30s
spring.cloud.azure.appconfiguration.stores[0].monitoring.triggers[0].key=sentinel

  2. Abra Azure Portal y vaya al recurso de App Configuration asociado a la aplicación. Seleccione Explorador de configuración en Operaciones y, después, + Crear>Par clave-valor para crear un par clave-valor y agregar los parámetros siguientes:

    Clave Value
    centinela 1

    Deje Etiqueta y Tipo de contenido en blanco, por ahora.

  3. Seleccione Aplicar.

  4. Compile la aplicación de Spring Boot con Maven y ejecútela.

    mvn clean package
mvn spring-boot:run

  5. Abra una ventana del explorador y vaya a la dirección URL: http://localhost:8080. Verá el mensaje asociado con la clave.

    También puede usar curl para probar la aplicación, por ejemplo:

    curl -X GET http://localhost:8080/

  6. Para probar la configuración dinámica, abra el portal de Azure App Configuration asociado a la aplicación. Seleccione Explorador de configuración y actualice el valor de la clave que se muestra, por ejemplo:

    Clave Value
    /application/config.message Hello: actualizado

  7. Actualice a un nuevo valor la clave de Sentinel que ha creado antes. Este cambio hace que la aplicación actualice todas las claves de configuración una vez que haya transcurrido el intervalo de actualización.

    Clave Value
    centinela 2

  8. Actualice la página del explorador dos veces para ver el nuevo mensaje que se muestra. La primera vez desencadena la actualización, la segunda carga los cambios, ya que la primera solicitud devuelve mediante el ámbito original.

Nota

La biblioteca solo comprueba si hay cambios después de que se haya pasado el intervalo de actualización. Si no se ha pasado el intervalo de actualización, no comprobará los cambios, tendrá que esperar a que pase el intervalo y, a continuación, desencadenar la comprobación de actualización.

Pasos siguientes

En este tutorial, ha habilitado la aplicación de Spring Boot para actualizar dinámicamente la configuración a partir de App Configuration. Puede encontrar más preguntas en la documentación de referencia, que contiene todos los detalles sobre cómo funciona la biblioteca de Azure App Configuration de Spring Cloud. Para obtener información sobre cómo usar una identidad administrada de Azure para simplificar el acceso a App Configuration, vaya al siguiente tutorial.

Integración de identidades administradas