Migrer Spring Cloud Config Server d'Azure Spring Apps vers Azure Container Apps
Remarque
Les plans Essentiel, Standard et Entreprise seront déconseillés à compter de la mi-mars 2025, avec une période de mise hors service de 3 ans. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez l’annonce de mise hors service d’Azure Spring Apps.
Le plan de consommation standard et dédiée sera déconseillé à compter du 30 septembre 2024, avec un arrêt complet après six mois. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez Migrer le plan de consommation standard et dédiée Azure Spring Apps vers Azure Container Apps.
Cet article s’applique à :✅ Essentiel/Standard ✅ Entreprise
Cet article décrit comment migrer Spring Cloud Config Server vers Config Server pour Spring dans Azure Container Apps. Azure Container Apps gère Config Server pour Spring, qui possède des fonctions similaires à Spring Cloud Config Server dans Azure Spring Apps.
Prérequis
- Une instance Azure Spring Apps avec Configure Server activé.
- Un environnement Azure Container Apps pour Config Server et une instance Azure Container Apps.
Serveur de configuration de provisionnement
Les étapes suivantes vous montrent comment provisionner un serveur de configuration pour Spring dans vos azure Container Apps :
Accédez à votre environnement Azure Container Apps dans le Portail Microsoft Azure.
Dans le menu, sélectionnez Services>Services.
Ouvrez la liste déroulante Configurer, puis sélectionnez Composant Java.
Dans le panneau Configurer le composant Java, entrez les valeurs suivantes :
Propriété Valeur Type de composant Java Sélectionnez Config Server pour Spring. Nom du composant Java Entrez configserver. Dans la section Référentiels Git, sélectionnez Ajouter, puis migrez les valeurs du service de configuration d’application vers ici, comme indiqué dans le tableau suivant. Choisissez un référentiel comme référentiel par défaut de Config Server pour Spring.
Propriété Valeur Type Sélectionnez PAR DÉFAUT. URI Entrez la valeur de l'URI du référentiel. Nom de la branche Entrez la valeur du label du référentiel. Chemins de recherche Entrez la valeur du chemin de recherche du référentiel. Authentification Sélectionnez le type d’authentification du référentiel et saisissez les informations correspondantes. Laissez le reste des champs avec les valeurs par défaut, puis sélectionnez Ajouter.
Si vous disposez de plusieurs référentiels, sélectionnez Ajouter pour migrer d’autres référentiels. Pour Type, sélectionnez Autre, puis migrez les autres propriétés comme indiqué à l'étape précédente et dans le tableau suivant :
Propriété Valeur Type Sélectionnez PAR DÉFAUT. Modèle Saisissez la valeur des Modèles pour le référentiel au format {application}ou{application}/{profile}.Dans la section Liaison, ouvrez la liste déroulante pour sélectionner les applications à lier au serveur de configuration pour Spring.
Cliquez sur Suivant.
Pour configurer Config Server, dans l’onglet Révision, sélectionnez Configurer, puis suivez les instructions de la section de configuration.
Une fois la création réussie, vous pouvez voir que l'état de provisionnement de Config Server pour Spring est Réussi.
Allocation des ressources
L'allocation des ressources du conteneur pour le serveur de configuration géré dans Azure Container Apps est fixée sur les valeurs suivantes :
- CPU : 0.5 vCPU
- Memory : 1 Gi
Pour configurer le nombre d’instances de Config Server pour Spring, vous devez mettre à jour les paramètres --min-replicas et --max-replicas avec la même valeur. Cette configuration garantit que le nombre d'instances reste fixe. Actuellement, le système ne prend pas en charge les configurations de mise à l’échelle automatique pour la mise à l’échelle dynamique.
Configurer le serveur de configuration
Mappez le référentiel Git par défaut et les référentiels supplémentaires configurés dans Spring Cloud Config Server dans Azure Spring Apps aux référentiels par défaut et autres dans Config Server pour Spring déployés dans Azure Container Apps. Le tableau suivant montre les relations de mappage pour les propriétés :
| Nom de la propriété dans Azure Spring Apps | CONFIGURATION_KEY |
CONFIGURATION_VALUE |
|---|---|---|
uri |
spring.cloud.config.server.git.uri spring.cloud.config.server.git.repos.{repoName}.uri |
Le uri du référentiel distant. |
search path |
spring.cloud.config.server.git.search-paths spring.cloud.config.server.git.repos.{repoName}.search-paths |
Recherchez les chemins à utiliser dans la copie de travail locale. Par défaut, recherche uniquement la racine. |
label |
spring.cloud.config.server.git.default-label spring.cloud.config.server.git.repos.{repoName}.default-label |
L'étiquette utilisée pour Git. |
name dans des référentiels supplémentaires |
{repoName} dans les configurations suivantes. |
|
Patterns dans des référentiels supplémentaires |
spring.cloud.config.server.git.repos.{repoName}.pattern |
|
username |
spring.cloud.config.server.git.username spring.cloud.config.server.git.repos.{repoName}.username |
Saisissez username pour l'authentification avec le référentiel distant si le type d'authentification est HTTP Basic. |
password |
spring.cloud.config.server.git.password spring.cloud.config.server.git.repos.{repoName}.password |
Saisissez password pour l'authentification avec le référentiel distant si le type d'authentification est HTTP Basic. |
private key |
spring.cloud.config.server.git.private-key spring.cloud.config.server.git.repos.{repoName}.private-key |
Clé privée SSH valide si le type d'authentification est SSH. |
host key |
spring.cloud.config.server.git.host-key spring.cloud.config.server.git.repos.{repoName}.host-key |
Clé d'hôte SSH valide si le type d'authentification est SSH. Doit être défini si host-key-algorithm est également défini. |
host key algorithm |
spring.cloud.config.server.git.host-key-algorithm spring.cloud.config.server.git.repos.{repoName}.host-key-algorithm |
L'un des ssh-dss, ssh-rsa, ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ou ecdsa-sha2-nistp521 si le type d'authentification est SSH. Doit être défini si la clé hôte est également définie. |
Pour plus de propriétés Config Server, consultez la section Options de configuration de Se connecter à un serveur de configuration géré pour Spring dans Azure Container Apps.
Déployer l’application sur Azure Container Apps
Après avoir testé l’application localement, vous pouvez déployer la nouvelle image sur l’application Azure Container Apps.
Suivez les étapes suivantes pour déployer :
- Accédez à votre application Azure Container Apps dans le Portail Microsoft Azure.
- Dans le menu, sélectionnez Conteneurs d’>application.
- Sélectionnez Modifier et déployer pour ouvrir la page Créer et déployer une nouvelle révision.
- Dans la section Image du conteneur, sélectionnez l’image, puis sélectionnez Modifier.
- Dans la section Modifier un conteneur, sous l’onglet Propriétés, choisissez la nouvelle image de l’application.
- Dans l’onglet Variables d’environnement, pour Nom, spécifiez spring.application.name. Ensuite, pour Source, choisissez Saisie manuelle et spécifiez le nom du fichier de configuration dans lequel l’application consomme la configuration.
- Sélectionnez Enregistrer pour déployer la nouvelle révision.
Résolution des problèmes
Vous pouvez afficher les journaux du serveur de configuration géré pour Spring dans Azure Container Apps à l’aide de Log Analytics. Utiliser les étapes suivantes :
Accédez à votre environnement Azure Container Apps dans le Portail Microsoft Azure.
Sélectionnez le menu Journaux>de surveillance.
Pour afficher les journaux, entrez une requête dans l'éditeur de requêtes pour la table
ContainerAppSystemLogs_CL, comme indiqué dans l'exemple suivant :ContainerAppSystemLogs_CL | where ComponentType_s == "SpringCloudConfig" | project Time=TimeGenerated, ComponentName=ComponentName_s, Message=Log_s | take 100
Pour plus d’informations sur l’interrogation des journaux, consultez Observabilité des composants Java gérés dans Azure Container Apps.