Migrer le service de configuration des applications vers Spring Cloud Config Server managé

Remarque

Les abonnements Basic, Standard et Enterprise sont entrés dans une période de retraite le 17 mars 2025. Pour plus d’informations, consultez l’annonce de mise hors service d’Azure Spring Apps.

Cet article s’applique à : ❎ Essentiel/Standard ✅ Entreprise

Cet article explique comment migrer du service de configuration des applications (ACS) vers Spring Cloud Config Server lors de l’utilisation du plan Azure Spring Apps Enterprise avec des applications Java.

Spring Cloud Config Server fournit un service de configuration centralisé que les applications peuvent utiliser pour extraire des propriétés de configuration à partir de sources externes, telles que des référentiels Git.

Approvisionner Spring Cloud Config Server

Si vous disposez d’une instance de plan Azure Spring Apps Enterprise avec le service de configuration des applications activé, la première étape de la migration d’ACS vers Spring Cloud Config Server consiste à approvisionner le serveur de configuration dans votre environnement Azure Spring Apps. Vous pouvez l’approvisionner à l’aide du portail Azure ou d’Azure CLI.

portail Azure
Azure CLI

Pour approvisionner Spring Cloud Config Server, effectuez les étapes suivantes :

Accédez à votre instance d’entreprise Azure Spring Apps dans le portail Azure.
Dans le menu, sélectionnez Spring Cloud Config Server.
Sélectionnez Gérer pour voir si Spring Cloud Config Server est activé. Si ce n’est pas le cas, activez-le, puis sélectionnez Appliquer pour enregistrer.
Une fois la mise à jour réussie, vous pouvez voir que l’État d’approvisionnement du serveur de configuration est Réussi sous l’onglet Vue d’ensemble.

Utilisez les commandes suivantes pour vous connecter à Azure CLI, et choisissez l’abonnement de votre service Azure Spring Apps :
```
az login
az account list --output table
az account set --subscription <subscription-ID>
```

Utilisez la commande suivante pour approvisionner Spring Cloud Config Server :

az spring config-server create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

Configurer Spring Cloud Config Server

Après avoir approvisionné Spring Cloud Config Server, l’étape suivante consiste à le configurer pour votre application afin de garantir une migration fluide.

portail Azure
Azure CLI

Pour configurer Spring Cloud Config Server dans le portail Azure, effectuez les étapes suivantes :

Dans votre instance d’Azure Spring Apps, accédez à Spring Cloud Config Server.
Sous l’onglet Paramètres, mappez les configurations de tous les référentiels d’ACS à Spring Cloud Config Server.

Si vous n’avez qu’un seul référentiel dans ACS, mappez-le au référentiel par défaut pour Spring Cloud Config Server sans nom et modèles. Si vous avez plusieurs référentiels dans ACS, choisissez un référentiel comme référentiel par défaut pour Spring Cloud Config Server, et utilisez les autres référentiels en tant que référentiels supplémentaires. Migrez les propriétés, notamment uri, label, search path, name, et authentication d’ACS vers Spring Cloud Config Server.
Après avoir mappé les configurations, sélectionnez Valider pour vérifier la configuration.
Une fois la validation réussie, sélectionnez Appliquer pour terminer la configuration de Spring Cloud Config Server.
Pour appliquer les modifications, sous l’onglet Liaison d’application, sélectionnez Lier l’application, puis sélectionnez toutes les applications devant utiliser Spring Cloud Config Server.

Utilisez la commande suivante pour définir la propriété Git de Spring Cloud Config Server. Les valeurs des propriétés sont des références d’ACS.
```
az spring config-server git set \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --uri <uri-of-git-repository> \
    --label <label-of-git-repository>
```
Si vous utilisez l’authentification de base ou l’authentification SSH pour votre référentiel Git, utilisez les paramètres --password et private-key.

Si vous avez plusieurs référentiels dans ACS, vous pouvez ajouter d’autres référentiels Git dans Spring Cloud Config Server avec la commande :

az spring config-server git repo add \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --repo-name <repo-name> \
    --uri <uri-of-git-repository> \
    --label <label-of-git-repository>

Liez vos applications devant utiliser Spring Cloud Config Server avec la commande suivante :

az spring config-server bind \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --app <app-name>

Pour migrer la propriété pattern d’ACS, il est important de s’assurer que le nom de votre application d’Azure Spring Apps correspond au nom du fichier de configuration dans le référentiel Git.

Si le nom de l’application d’Azure Spring Apps correspond au nom du fichier de configuration, Spring Cloud Config Server applique automatiquement le fichier de configuration avec le nom correspondant à l’application, sans nécessiter de configuration supplémentaire.
Si les noms ne correspondent pas, vous devez créer une application avec le nom comme nom de fichier de configuration.

Pour plus de configurations, consultez ce document sur Spring Cloud Config Server.

Mettez à jour la configuration de votre application

En raison des différences dans les mécanismes d’implémentation entre ACS et Config Server, certaines modifications de configuration d’application sont nécessaires pour s’adapter à la façon dont les configurations sont extraites.

Après avoir approvisionné et configuré Spring Cloud Config Server, vous devez ajuster votre configuration en effectuant les étapes suivantes :

Mettez à jour les dépendances Spring Boot en ajoutant les dépendances Spring Cloud Config suivantes à votre fichier pom.xml pour Maven ou build.gradle pour Gradle.

Maven
Gradle

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-config</artifactId>
</dependency>

dependencies {
    implementation 'org.springframework.cloud:spring-cloud-starter-config'
}

Configurez le profil.

Dans ACS, vous fournissez le profil en tant que modèles dans un déploiement Azure Spring Apps, tandis que dans Spring Cloud Config Server, vous configurez le profil dans le code source d’une application.

Vérifiez que votre application utilise les profils appropriés, dev, prod, et ainsi de suite, afin que le serveur Spring Cloud Config Server puisse servir des configurations propres à l’environnement.

Mettez à jour le fichier bootstrap.yml ou application.yml dans votre application avec les propriétés de configuration appropriées afin qu’il pointe vers Spring Cloud Config Server, comme illustré dans l’exemple suivant :
```
spring:
  cloud:
    config:
      profile: dev
```
Vérifiez que le nom de l’application d’Azure Spring Apps correspond au nom du fichier de configuration dans votre référentiels Git. Évitez également de configurer spring.application.name dans le code de votre application.

Redéployer l’application

Après avoir testé l’application localement, vous pouvez la redéployer dans Azure Spring Apps pour utiliser Spring Cloud Config Server à l’aide de la commande Azure CLI suivante :

az spring app deploy \
    --name <app-name> \
    --artifact-path <path-to-your-app> \
    --config-file-patterns '""'

Avec le paramètre --config-file-patterns '""', elle nettoie la référence du service de configuration des applications dans votre application. L’application consomme la configuration via Spring Cloud Config Server plutôt que via le service de configuration des applications.

Désactiver le service de configuration des applications

Une fois que toutes les applications ont terminé la migration vers Spring Cloud Config Server, vous pouvez dissocier ces applications du service de configuration des applications et désactiver ACS.

portail Azure
Azure CLI

Dans votre instance d’Azure Spring Apps, accédez au service de configuration des applications
Ouvrez l’onglet Liaison d’application, puis sélectionnez chaque application liée à dissocier.
Une fois toutes les applications dissociées, sélectionnez Gérer pour désactiver le service de configuration des applications.

Pour dissocier des applications à partir d’ACS, utilisez la commande suivante :

az spring application-configuration-service unbind \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --app <application-name>

Une fois toutes les applications dissociées, désactivez ACS à l’aide de la commande suivante :

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

En suivant attentivement ces étapes, vous pouvez garantir une migration fluide et utiliser les avantages de Spring Cloud Config Server dans Azure Spring Apps.

Limitation connue

La migration d’ACS vers Spring Cloud Config Server s’applique uniquement aux applications Java, car ACS gère la configuration à l’aide du ConfigMap natif Kubernetes. Cette méthode permet des mises à jour de configuration dynamiques dans les environnements Kubernetes, ce qui la rend polyvalente pour différentes applications avec plusieurs langages de programmation. Spring Cloud Config Server est principalement conçu pour les applications Java, utilisant des fonctionnalités Spring Framework. Il prend donc uniquement en charge la gestion de la configuration pour Java.

Commentaires

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

Last updated on 2025-10-31