Démarrage rapide : Ajouter des indicateurs de fonctionnalité à une application Spring Boot

Dans ce guide de démarrage rapide, vous allez créer un indicateur de fonctionnalité dans Azure App Configuration et l'utiliser pour contrôler dynamiquement les applications Spring Boot pour créer une implémentation de bout en bout de la gestion des fonctionnalités.

Les bibliothèques de gestion des fonctionnalités de Spring Boot n'ont pas de dépendance sur les bibliothèques Azure. Elles s’intègrent de manière fluide à App Configuration par le biais de son fournisseur de configuration Spring Boot.

Prérequis

Compte Azure avec un abonnement actif. Créez-en un gratuitement.
Un magasin App Configuration, comme illustré dans le tutoriel pour la création d’un magasin.
Un SDK Java pris en charge avec la version 17.
Apache Maven version 3.0 ou ultérieure

Ajouter un indicateur de fonctionnalité

Ajoutez un indicateur de fonctionnalité appelé Bêta au magasin App Configuration et laissez les valeurs par défaut à Étiquette et à Description. Pour plus d’informations sur l’ajout d’indicateurs de fonctionnalité à un magasin à l’aide du Portail Azure ou de CLI, accédez à Créer un indicateur de fonctionnalité. À ce stade, la case à cocher Activer l’indicateur de fonctionnalité doit être décochée.

Créer une application console

Créez un projet Spring Boot :
1. Accédez à Spring Initializr.
2. Spécifiez les options suivantes :
  - Générez un projet Maven avec Java.
  - Spécifiez une version Spring Boot égale ou supérieure à 3.0.
  - Indiquez les noms du Groupe et de l’Artefact de votre application. Cet article utilise com.example et demo.
3. Une fois les options précédentes spécifiées, sélectionnez Générer le projet. Téléchargez et extrayez le projet sur votre ordinateur local.
Recherchez pom.xml dans le répertoire racine de votre application et ouvrez-la dans un éditeur de texte.

Ajoutez ce qui suit à la liste 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>

Ajoutez la section <dependencyManagement> suivante pour gérer les versions de la bibliothèque 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>

Accédez au répertoire resources de votre application, puis ouvrez le fichier application.properties ou application.yaml.

Vous utilisez le DefaultAzureCredential pour vous authentifier auprès de votre magasin App Configuration. Pour que l’autorisation fonctionne, vous devez accorder le rôle Lecteur de données App Configuration aux informations d’identification que votre application utilise. Pour obtenir des instructions, consultez Authentification avec des informations d’identification de jeton. Veillez à laisser suffisamment de temps pour que l’autorisation se propage avant d’exécuter votre application.
- Propriétés
- 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
```

Mettez à jour le DemoApplication.java fichier dans le répertoire de package de votre application avec le code suivant :

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"));
        };
    }
}

Définissez une variable d’environnement nommée AZURE_APPCONFIG_ENDPOINT et définissez-la sur le point de terminaison de votre magasin App Configuration. Sur la ligne de commande, exécutez la commande suivante et redémarrez l’invite de commandes pour que la modification soit prise en compte :
```
setx AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
Redémarrez l’invite de commandes pour que la modification soit prise en compte. Vérifiez qu’elle est correctement définie en imprimant la valeur de la variable d’environnement.
```
$Env:AZURE_APPCONFIG_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Redémarrez l’invite de commandes pour que la modification soit prise en compte. Vérifiez qu’elle est correctement définie en imprimant la valeur de la variable d’environnement.
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Redémarrez l’invite de commandes pour que la modification soit prise en compte. Vérifiez qu’elle est correctement définie en imprimant la valeur de la variable d’environnement.
Générez et exécutez votre application Spring Boot avec Maven.
```
mvn clean package
mvn spring-boot:run
```
Dans le portail App Configuration, sélectionnez Gestionnaire de fonctionnalités, puis changez l’état de l’indicateur de fonctionnalité Bêta en Activé à l’aide du bouton bascule dans la colonne Activé.

Clé État

Bêta Il en va
Redémarrez-la. L’application imprime les éléments suivants :
```
Beta is enabled: true
```

Clé	État
Bêta	Il en va

Nettoyer les ressources

Si vous ne souhaitez plus utiliser les ressources créées dans cet article, supprimez le groupe de ressources que vous avez créé ici afin d’éviter des frais.

Important

La suppression d’un groupe de ressources est irréversible. Le groupe de ressources et toutes les ressources qu’il contient sont supprimés définitivement. Veillez à ne pas supprimer accidentellement les mauvaises ressources ou le mauvais groupe de ressources. Si vous avez créé les ressources pour cet article dans un groupe de ressources contenant d’autres ressources que vous souhaitez conserver, supprimez chaque ressource individuellement à partir de son volet, au lieu de supprimer l’intégralité du groupe de ressources.

Connectez-vous au portail Azure, puis sélectionnez Groupes de ressources.
Dans la zone Filtrer par nom, entrez le nom de votre groupe de ressources.
Dans la liste de résultats, sélectionnez le nom du groupe de ressources pour afficher une vue d’ensemble.
Sélectionnez Supprimer le groupe de ressources.
Vous êtes invité à confirmer la suppression du groupe de ressources. Entrez le nom de votre groupe de ressources à confirmer, puis sélectionnez Supprimer.

Après quelques instants, le groupe de ressources et toutes ses ressources sont supprimés.

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez créé un magasin App Configuration et l’avez utilisé pour gérer les fonctionnalités d’une application Spring Boot via les bibliothèques de gestion des fonctionnalités.

Découvrez plus d’informations sur la gestion des fonctionnalités.
Gérer les indicateurs de fonctionnalité.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-05-07