Inicio rápido: Creación de una aplicación de Java Spring con Azure App Configuration

En este inicio rápido incorporará Azure App Configuration a una aplicación de Java Spring para centralizar el almacenamiento y la administración de la configuración de la aplicación de forma independiente del código.

Prerrequisitos

• Una suscripción a Azure: cree una cuenta gratuita
• Un kit de desarrollo de Java (JDK) admitido, versión 8.
• Apache Maven, versión 3.0 o posterior.

Creación de un almacén de App Configuration

1. Para crear un almacén de App Configuration, inicie sesión en Azure Portal. En la esquina superior izquierda de la página principal, seleccione Crear un recurso. En el cuadro Buscar en Marketplace, escriba App Configuration y presione Entrar.

   

2. Seleccione Configuración de la aplicación en los resultados de la búsqueda y, después, Crear.

   

3. En el panel Crear de App Configuration, introduzca la siguiente configuración:

   Configuración	Valor sugerido	Descripción
   Suscripción	Su suscripción	Seleccione la suscripción de Azure que desee usar para probar App Configuration. Si su cuenta solo tiene una suscripción, se selecciona automáticamente y la lista Suscripción no aparece.
   Grupos de recursos	AppConfigTestResources	Seleccione o cree un grupo de recursos para el recurso del almacén de App Configuration. Este grupo es útil para organizar los distintos recursos que quiera eliminar al mismo tiempo mediante la eliminación del grupo de recursos. Para más información, consulte Administración de los recursos de Azure a través del Portal.
   Nombre del recurso	Nombre único globalmente	Escriba un nombre de recurso único para usarlo como recurso de almacén de App Configuration. El nombre debe ser una cadena de entre 5 y 50 caracteres y solo puede contener números, letras y el carácter -. El nombre no puede comenzar ni terminar con el carácter -.
   Ubicación	Centro de EE. UU.	Use Ubicación para especificar la ubicación geográfica en la que se hospeda el almacén de App Configuration. Para optimizar el rendimiento, cree el recurso en la misma región que los demás componentes de la aplicación.
   Plan de tarifa	Gratis	Seleccione el plan de tarifa deseado. Para más información, consulte la página de precios de App Configuration.

4. Seleccione Revisar y crear para validar la configuración.

5. Seleccione Crear. La implementación puede tardar unos minutos.

6. Una vez finalizada la implementación, vaya al recurso de App Configuration. Seleccione Configuración > Claves de acceso. Tome nota de la cadena de conexión de la clave de solo lectura principal. Usará esta cadena de conexión más adelante para configurar la aplicación y que se comunique con el almacén de Azure App Configuration que ha creado.

7. Seleccione Explorador de configuración > + Crear > Clave-valor para agregar los siguientes pares clave-valor:

   Clave	Value
   /application/config.message	Hola

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

8. Seleccione Aplicar.

Creación de una aplicación Spring Boot

Para crear un proyecto de Spring Boot, use Spring Initializr.

1. Vaya a https://start.spring.io/.

2. Especifique las opciones siguientes:

   • Genere un proyecto de Maven con Java.
   • Especifique una versión de Spring Boot igual o superior a la 2.0.
   • Especifique los nombres de Group (Grupo) y Artifact (Artefacto) de la aplicación.
   • Adición de la dependencia de Spring Web

3. Después de especificar las opciones anteriores, seleccione Generar proyecto. Cuando se le solicite, descargue el proyecto en una ruta de acceso del equipo local.

Conexión a un almacén de App Configuration

1. Después de extraer los archivos en el sistema local, la aplicación sencilla de Spring Boot estará lista para editarla. Busque el archivo pom.xml en el directorio raíz de la aplicación.

2. Abra el archivo pom.xml en un editor de texto y agregue el iniciador Spring Cloud Azure Config a la lista <dependencies>:

   Spring Boot 2.4

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

   Nota

   Si necesita compatibilidad con una versión anterior de Spring Boot, consulte la biblioteca antigua.

3. Cree un archivo Java llamado MessageProperties.javaº en el directorio del paquete de la aplicación. Agregue las siguientes líneas:

   package com.example.demo;
   
   import org.springframework.boot.context.properties.ConfigurationProperties;
   
   @ConfigurationProperties(prefix = "config")
   public class MessageProperties {
       private String message;
   
       public String getMessage() {
           return message;
       }
   
       public void setMessage(String message) {
           this.message = message;
       }
   }
   

4. Cree un archivo Java nuevo llamado HelloController.java en el directorio del paquete de la aplicación. Agregue las siguientes líneas:

   package com.example.demo;
   
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @RestController
   public class HelloController {
       private final MessageProperties properties;
   
       public HelloController(MessageProperties properties) {
           this.properties = properties;
       }
   
       @GetMapping
       public String getMessage() {
           return "Message: " + properties.getMessage();
       }
   }
   

5. Abra el archivo de Java de la aplicación principal y agregue @EnableConfigurationProperties para habilitar esta característica.

   import org.springframework.boot.context.properties.EnableConfigurationProperties;
   
   @SpringBootApplication
   @EnableConfigurationProperties(MessageProperties.class)
   public class DemoApplication {
       public static void main(String[] args) {
           SpringApplication.run(DemoApplication.class, args);
       }
   }
   

6. Cree un nuevo archivo denominado bootstrap.properties bajo el directorio de recursos de la aplicación y agréguele las siguientes líneas. Reemplace los valores de ejemplo por las propiedades adecuadas para su almacén de App Configuration.

   spring.cloud.azure.appconfiguration.stores[0].connection-string= ${APP_CONFIGURATION_CONNECTION_STRING}
   

7. Establezca una variable de entorno llamada APP_CONFIGURATION_CONNECTION_STRING y defínala como la clave de acceso a su almacén de App Configuration. En la línea de comandos, ejecute el siguiente comando y reinicie el símbolo del sistema para que se aplique el cambio:

   setx APP_CONFIGURATION_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
   

   Si usa Windows PowerShell, ejecute el siguiente comando:

   $Env:APP_CONFIGURATION_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
   

   Si usa macOS o Linux, ejecute el siguiente comando:

   export APP_CONFIGURATION_CONNECTION_STRING='connection-string-of-your-app-configuration-store'
   

Compilación y ejecución de la aplicación en un entorno local

1. Compile la aplicación de Spring Boot con Maven y ejecútela; por ejemplo:

   mvn clean package
   mvn spring-boot:run
   

2. Una vez que se está ejecutando la aplicación, puede usar curl para probarla, por ejemplo:

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

   Verá el mensaje que escribió en el almacén de App Configuration.

Limpieza de recursos

Si no desea seguir usando los recursos creados en este artículo, elimine el grupo de recursos que creó aquí para evitar cargos.

1. Inicie sesión en Azure Portal y después seleccione Grupos de recursos.
2. En el cuadro de texto Filtrar por nombre, escriba el nombre del grupo de recursos.
3. En la lista resultados, seleccione el nombre del grupo de recursos para ver la información general.
4. Seleccione Eliminar grupo de recursos.
5. Se le pedirá que confirme la eliminación del grupo de recursos. Escriba el nombre del grupo de recursos para confirmar y seleccione Eliminar.

Transcurridos unos instantes, el grupo de recursos y todos sus recursos se eliminan.

Pasos siguientes

En este inicio rápido, ha creado un almacén de App Configuration y lo ha usado con una aplicación de Java Spring. Para más información, consulte Spring en Azure. Para aprender a habilitar la aplicación de Java Spring y actualizar dinámicamente la configuración, continúe con el siguiente tutorial.