Inicio rápido: agregar marcas de características a aplicaciones de Spring Boot

En este inicio rápido, vas a crear una bandera de características en Azure App Configuration y usarla para controlar dinámicamente las aplicaciones de Spring Boot y lograr una implementación completa de la administración de características.

Las bibliotecas de Administración de características de Spring Boot no tienen una dependencia de las bibliotecas de Azure. Se integran sin problemas con App Configuration mediante su proveedor de configuración de Spring Boot.

Requisitos previos

Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.
Un almacén de App Configuration, como se muestra en el tutorial para crear un almacén.
Un Kit de desarrollo de Java compatible con la versión 17.
Apache Maven, versión 3.0 o posterior.

Agregar marca de característica

Agregue una marca de característica denominada Beta al almacén de App Configuration y deje Etiqueta y Descripción con sus valores predeterminados. Para obtener más información sobre cómo agregar marcas de características a un almacén mediante Azure Portal o la CLI, vaya a Creación de una marca de característica. En esta fase, la casilla de verificación del indicador de función debe estar desactivada.

Creación de una aplicación de consola

Cree un nuevo proyecto de Spring Boot:
1. Vaya a Spring Initializr.
2. Especifique las opciones siguientes:
  - Genere un proyecto de Maven con Java.
  - Especifique una versión de Spring Boot igual o mayor que 3.0.
  - Especifique los nombres de Group (Grupo) y Artifact (Artefacto) de la aplicación. En este artículo se usan com.example y demo.
3. Después de especificar las opciones anteriores, seleccione Generar proyecto. Descargue y extraiga el proyecto en el equipo local.
Busque pom.xml en el directorio raíz de la aplicación y ábralo en un editor de texto.

Agregue lo siguiente a la lista de <dependencies>:

<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-appconfiguration-config</artifactId>
</dependency>
<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-feature-management</artifactId>
</dependency>

Agregue la siguiente sección <dependencyManagement> para administrar las versiones de la biblioteca de Spring Cloud Azure:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.azure.spring</groupId>
            <artifactId>spring-cloud-azure-dependencies</artifactId>
            <version>7.2.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Vaya al directorio resources de la aplicación y abra el archivo application.properties o application.yaml.

Use DefaultAzureCredential para autenticarse en el almacén de App Configuration. Para que la autorización funcione, debe conceder el rol Lector de Datos de Configuración de la Aplicación a la credencial que usa su aplicación. Para obtener instrucciones, consulte Autenticación con credenciales de token. Asegúrese de permitir el tiempo suficiente para que el permiso se propague antes de ejecutar la aplicación.
- Propiedades
- YAML
```
spring.config.import=azureAppConfiguration
spring.cloud.azure.appconfiguration.stores[0].endpoint= ${AZURE_APPCONFIG_ENDPOINT}
spring.cloud.azure.appconfiguration.stores[0].feature-flags.enabled=true
```
```
spring:
  config:
    import: azureAppConfiguration
  cloud:
    azure:
      appconfiguration:
        stores:
          - endpoint: ${AZURE_APPCONFIG_ENDPOINT}
            feature-flags:
              enabled: true
```

Actualice el DemoApplication.java archivo en el directorio del paquete de la aplicación con el código siguiente:

import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;

import com.azure.spring.cloud.feature.management.FeatureManager;

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    @Bean
    public CommandLineRunner runner(FeatureManager featureManager) {
        return args -> {
            System.out.println("Beta is enabled: " + featureManager.isEnabled("Beta"));
        };
    }
}

Establezca una variable de entorno denominada AZURE_APPCONFIG_ENDPOINT y asígnela al punto de conexión de 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 AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
Reinicie el símbolo del sistema para permitir que el cambio surta efecto. Compruebe que se establece correctamente imprimiendo el valor de la variable de entorno.
```
$Env:AZURE_APPCONFIG_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Reinicie el símbolo del sistema para permitir que el cambio surta efecto. Compruebe que se establece correctamente imprimiendo el valor de la variable de entorno.
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Reinicie el símbolo del sistema para permitir que el cambio surta efecto. Compruebe que se establece correctamente imprimiendo el valor de la variable de entorno.
Compile y ejecute la aplicación de Spring Boot con Maven.
```
mvn clean package
mvn spring-boot:run
```
En el portal de App Configuration, seleccione Administrador de características y cambie el estado de la marca de características Beta a Activada, con el botón de alternancia en la columna Habilitada.

Clave Estado

Beta Por
Reinicie la aplicación. La aplicación imprimirá lo siguiente:
```
Beta is enabled: true
```

Clave	Estado
Beta	Por

Limpieza de recursos

Si no quiere seguir usando los recursos que se han creado en este artículo, elimine el grupo de recursos se que ha creado con el fin de evitar cargos.

Importante

La eliminación de un grupo de recursos es irreversible. El grupo de recursos y todos los recursos que contiene se eliminan permanentemente. Asegúrese de no eliminar accidentalmente el grupo de recursos o los recursos equivocados. Si creó los recursos para este artículo en un grupo de recursos que contenga los recursos que desee conservar, elimine cada recurso de forma individual desde su panel respectivo, en lugar de eliminar el grupo de recursos.

Inicie sesión en Azure Portal y después seleccione Grupos de recursos.
En el cuadro de texto Filtrar por nombre, escriba el nombre del grupo de recursos.
En la lista resultados, seleccione el nombre del grupo de recursos para ver la información general.
Seleccione Eliminar grupo de recursos.
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, creó un nuevo almacén de configuración de aplicaciones y lo utilizó para administrar características en una aplicación Spring Boot a través de las bibliotecas de gestión de características.

Más información sobre la administración de características.
Administración de marcas de características.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-05-07