Migrer une instance Azure Spring Apps de plan De base ou Standard vers le plan Entreprise

Remarque

Azure Spring Apps est le nouveau nom du service Azure Spring Cloud. Bien que le service ait un nouveau nom, vous verrez l’ancien nom à divers endroits pendant un certain temps, car nous travaillons à mettre à jour les ressources telles que les captures d’écran, les vidéos et les diagrammes.

Cet article s’applique au : Niveau ✔️ De base/Standard ✔️ Entreprise

Cet article explique comment migrer une application existante dans le plan De base ou Standard vers le plan Entreprise. Lorsque vous migrez du plan De base ou Standard vers le plan Entreprise, les composants VMware Tanzu remplacent les composants Open Source Software (OSS) Spring Cloud pour fournir une prise en charge des fonctionnalités supplémentaires.

Cet article utilise les exemples d’applications Pet Clinic comme exemples de migration.

Prérequis

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.
• Azure CLI version 2.45.0 ou ultérieure.
• L’extension de plan Enterprise d’Azure Spring Apps. Utilisez la commande suivante pour supprimer les versions précédentes et installer l’extension de plan Enterprise la plus récente. Si vous avez déjà installé l’extension spring-cloud, désinstallez-la pour éviter les incompatibilités de configuration et de version.

  az extension add --upgrade --name spring
  az extension remove --name spring-cloud
  

• Git.

Provisionner une instance de service

Dans le plan Azure Spring Apps Enterprise, les composants VMware Tanzu remplacent les composants OSS Spring Cloud pour fournir davantage de prise en charge des fonctionnalités. Les composants Tanzu sont activés à la demande en fonction de vos besoins. Vous devez activer les composants dont vous avez besoin avant de créer l’instance de service Azure Spring Apps.

Remarque

Pour utiliser les composants Tanzu, vous devez les activer lors du provisionnement de votre instance de service Azure Spring Apps. Vous ne pouvez pas les activer après le provisionnement pour l’instant.

Effectuez les étapes suivantes pour provisionner une instance de service Azure Spring Apps :

Azure portal

1. Ouvrez le portail Azure.

2. Dans la zone de recherche en haut, recherchez Azure Spring Apps.

3. Sélectionnez Azure Spring Apps dans les résultats, puis sélectionnez Créer.

4. Dans la page Créer Azure Spring Apps, définissez votre abonnement, votre groupe de ressources et votre nom pour l’instance.

5. Pour Planifier dans les détails du service, sélectionnez Modifier.

   

6. Dans la page Choisir votre plan , sélectionnez la ligne Entreprise dans le tableau, puis sélectionnez Sélectionner.

   

7. Dans la page Créer Azure Spring Apps, sélectionnez Conditions d’utilisation pour accepter les conditions légales et les déclarations de confidentialité de l’offre de plan Entreprise dans le Place de marché Azure.

8. Sélectionnez Suivant : Paramètres VMware Tanzu.

9. Sous l’onglet Paramètres de VMWare Tanzu, faites défiler la liste pour passer en revue les composants Tanzu. Tous les composants sont activés par défaut.

   

   Remarque

   Déterminez soigneusement les composants Tanzu à utiliser ou activer pendant la phase de provisionnement. Une fois le provisionnement de l’instance Azure Spring Apps effectué, vous ne pourrez plus activer ni désactiver les composants Tanzu.

10. Sélectionnez l’onglet Application Recommandations, puis activez l’Recommandations d’application. Passez en revue les paramètres suivants :

    • Activer l’Recommandations d’application doit être sélectionné.
    • Choisissez une instance Application Insights existante ou créez une nouvelle instance Application Insights.
    • Entrez un taux d’échantillonnage dans la plage de 0 à 100, ou utilisez la valeur par défaut 10.

    Vous pouvez également activer Application Insights une fois que vous avez provisionné l’instance Azure Spring Apps. Pour plus d’informations sur la tarification des Recommandations d’application, consultez la section de facturation de l’application Recommandations des calculs et options de coût des journaux Azure Monitor.

    Remarque

    Vous payez pour l’utilisation d’Application Insights lorsque celui est intégré à Azure Spring Apps.

11. Sélectionnez Vérifier et créer, attendez la fin de la validation, puis sélectionnez Créer pour démarrer le provisionnement de l’instance de service.

Le provisionnement des ressources prend environ 5 minutes.

Azure CLI

1. Utilisez la commande suivante pour mettre à jour Azure CLI avec l’extension Azure Spring Apps :

   az extension add --upgrade --name spring
   

2. Utilisez les commandes suivantes pour vous connecter à Azure CLI et choisir votre abonnement actif :

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

3. Utilisez la commande suivante pour accepter les conditions d’utilisation et la déclaration de confidentialité du niveau Enterprise. Cette étape est requise uniquement la première fois que vous créez une instance Azure Spring Apps sur le plan Entreprise.

   az provider register --namespace Microsoft.SaaS
   az term accept --publisher vmware-inc --product azure-spring-cloud-vmware-tanzu-2 --plan asa-ent-hr-mtr
   

4. Créez un nom pour votre instance de service Azure Spring Apps. Le nom doit comporter entre 4 et 32 caractères, et peut contenir uniquement des lettres minuscules, des chiffres et des traits d’union. Le premier caractère du nom du service doit être une lettre, et le dernier doit être une lettre ou un chiffre.

5. Utilisez la commande suivante pour créer un groupe de ressources et une instance de service Azure Spring Apps :

   az spring create \
       --resource-group <resource-group-name> \
       --name <Azure-Spring-Apps-service-instance-name> \
       --sku enterprise
   

   Pour plus d’informations sur les groupes de ressources, consultez Qu’est-ce qu’Azure Resource Manager ?.

Créer et configurer des applications

Les étapes de création d’application sont identiques au plan Standard.

1. Utilisez la commande suivante pour définir les valeurs par défaut d’Azure CLI. Veillez à remplacer les espaces réservés par vos valeurs.

   az config set defaults.group=<resource-group-name>
   az config set defaults.spring=<Azure-Spring-Apps-service-instance-name>
   

2. Utilisez les commandes suivantes pour créer les deux applications principales pour PetClinic et api-gatewaycustomers-service:

   az spring app create --name api-gateway --instance-count 1 --memory 2Gi --assign-endpoint
   az spring app create --name customers-service --instance-count 1 --memory 2Gi
   

Utiliser le service de configuration des applications pour la configuration externe

Pour la configuration externalisée dans un système distribué, le serveur de configuration Spring Cloud managé (OSS) est disponible uniquement dans les plans De base et Standard. Dans le plan Entreprise, le service de configuration d’application pour Tanzu fournit des fonctions similaires pour vos applications. Le tableau suivant décrit certaines différences d’utilisation entre le serveur de configuration OSS et le service de configuration d’application.

Composant	Plans de support	Enabled	Liaison à l’application	Profil
Serveur de configuration Spring Cloud	De base/Standard	Toujours activé.	Liaison automatique	Configuré dans le code source de l’application.
Service de configuration des applications pour Tanzu	Enterprise	Activer à la demande.	Liaison manuelle	Fourni comme config-file-pattern dans un déploiement Azure Spring Apps.

Contrairement au mode client-serveur du serveur de configuration OSS, Application Configuration Service gère la configuration à l’aide de Kubernetes native ConfigMap, qui est remplie à partir des propriétés définies dans les référentiels Git back-end. Le service de configuration d’application ne peut pas obtenir le profil actif configuré dans le code source de l’application pour qu’il corresponde à la configuration appropriée. La configuration config-file-pattern explicite doit donc être spécifiée au niveau du déploiement d’Azure Spring Apps.

Configurer le service de configuration d’application pour Tanzu

Suivez ces étapes pour utiliser le service de configuration d’application pour Tanzu en tant que service de configuration centralisé.

Azure portal

1. Dans votre instance Azure Spring Apps Enterprise, sélectionnez Service de configuration d’application dans le volet de navigation. Affichez l’état d’exécution et les ressources alloués au service de configuration d’application pour Tanzu.

   

2. Sélectionnez Paramètres et remplissez le formulaire dans Référentiels pour ajouter une nouvelle entrée avec les informations suivantes :

   • Nom : default
   • Modèles : api-gateway,customers-service
   • URI : https://github.com/Azure-Samples/spring-petclinic-microservices-config
   • Étiquette : master

   

3. Pour valider l’accès à l’URI cible, sélectionnez Valider.

4. Une fois la validation terminée, sélectionnez Appliquer pour mettre à jour les paramètres de configuration.

Azure CLI

Utilisez la commande suivante pour définir le référentiel par défaut :

az spring application-configuration-service git repo add \
    --name default \
    --patterns api-gateway,customers-service \
    --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
    --label master

Lier des applications au service de configuration d’application pour Tanzu

Lorsque vous utilisez le service de configuration d’application pour Tanzu avec un back-end Git, vous devez lier l’application au service de configuration d’application pour Tanzu. Après la liaison de l’application, vous devez configurer le modèle utilisé par l’application. Procédez comme suit pour lier et configurer le modèle pour l’application.

Azure portal

Procédez comme suit pour lier des applications au service de configuration d’application pour VMware Tanzu.

1. Dans votre instance Azure Spring Apps Enterprise, sélectionnez Service de configuration d’application dans le volet de navigation.

2. Sélectionnez Liaison d’application, puis l’application Lier.

   

3. Sélectionnez une application dans le menu déroulant, puis sélectionnez Appliquer pour lier l’application au service de configuration d’application pour Tanzu.

Azure CLI

Utilisez les commandes suivantes pour lier des applications au service de configuration d’application pour VMware Tanzu et VMware Tanzu Service Registry :

az spring application-configuration-service bind --app api-gateway
az spring application-configuration-service bind --app customers-service

Pour plus d’informations, consultez Utiliser le service de configuration d’application pour Tanzu.

Utilisation de Service Registry pour Tanzu

Registre de services est l’un des composants propriétaires de VMware Tanzu. Il fournit à vos applications une implémentation du modèle Service Discovery, qui est l’un des concepts fondamentaux d’une architecture basée sur les microservices. Dans le plan Entreprise, Service Registry pour Tanzu fournit un registre de services et découvre la prise en charge de vos applications. Managed Spring Cloud Eureka est disponible uniquement dans le plan De base et Standard et n’est pas disponible dans le plan Entreprise.

Composant	Plan Standard	Plan Entreprise
Registre de service	OSS eureka Liaison automatique (toujours injection) Toujours provisionné	Registre de services pour Tanzu Nécessite une liaison manuelle à l’application Activer à la demande

Lier une application au registre de services Tanzu

Pour lier des applications au service de configuration d’application pour VMware Tanzu, procédez comme suit.

Azure portal

1. Dans votre instance Azure Spring Apps Enterprise, sélectionnez Service Registry.

2. Sélectionnez Liaison d’application. Les applications actuellement liées apparaissent sous le nom de l’application.

3. Sélectionnez Lier l’application.

4. Sélectionnez une application dans le menu déroulant, puis sélectionnez Appliquer pour lier l’application à Tanzu Service Registry.

   

Azure CLI

Utilisez les commandes suivantes pour lier des applications au service de configuration d’application pour VMware Tanzu et VMware Tanzu Service Registry :

az spring service-registry bind --app api-gateway
az spring service-registry bind --app customers-service

Remarque

Lorsque vous modifiez l’état de liaison, vous devez redémarrer ou redéployer l’application pour que le changement prenne effet.

Pour plus d’informations, consultez Utiliser le registre de services Tanzu.

Créer et déployer des applications

Dans le plan Entreprise, Tanzu Build Service est utilisé pour créer des applications. Il fournit plus de fonctionnalités comme les applications polyglottes à déployer à partir d’artefacts tels que le code source et les fichiers zip.

Pour utiliser Tanzu Build Service, vous devez spécifier une ressource pour la tâche de génération et le générateur à utiliser. Vous pouvez également spécifier le paramètre --build-env pour définir des environnements de build.

Si l’application est liée à Application Configuration Service pour Tanzu, vous devez spécifier un argument —config-file-patternsupplémentaire.

Pour plus d’informations, consultez Utiliser le service de build Tanzu.

Créer des applications localement

Procédez comme suit pour générer localement :

1. Utilisez les commandes suivantes pour cloner l’exemple de référentiel d’application dans votre compte Azure, modifier le répertoire et générer le projet :

   git clone -b enterprise https://github.com/azure-samples/spring-petclinic-microservices
   cd spring-petclinic-microservices
   mvn clean package -DskipTests
   

   La compilation du projet peut prendre plusieurs minutes. Une fois terminé, vous disposez de fichiers JAR individuels pour chaque service dans son dossier respectif.

2. Utilisez les commandes suivantes pour déployer les fichiers JAR générés à l’étape précédente :

   az spring app deploy \
       --name api-gateway \
       --artifact-path spring-petclinic-api-gateway/target/spring-petclinic-api-gateway-2.3.6.jar \
       --config-file-patterns api-gateway
   az spring app deploy \
       --name customers-service \
       --artifact-path spring-petclinic-customers-service/target/spring-petclinic-customers-service-2.3.6.jar \
       --config-file-patterns customers-service
   

3. Utilisez la commande suivante pour interroger l’état de l’application après le déploiement :

   az spring app list --output table
   

   Cette commande produit une sortie semblable à celle de l’exemple suivant :

   Name                  Location    ResourceGroup       Public Url                                                 Production Deployment    Provisioning State    CPU    Memory    Running Instance    Registered Instance    Persistent Storage    Bind Service Registry    Bind Application Configuration Service
   --------------------  ----------  ---------------  ---------------------------------------------------------  -----------------------  --------------------  -----  --------  ------------------  ---------------------  --------------------  -----------------------  ----------------------------------------
   api-gateway           eastus      <resource group>   https://<service_name>-api-gateway.asc-test.net                    default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
   customers-service     eastus      <resource group>                                                                      default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
   

Utiliser Application Insights

Le plan Azure Spring Apps Enterprise utilise des liaisons buildpack pour intégrer application Recommandations au type ApplicationInsights au lieu de l’agent in-process. Pour plus d’informations, consultez Comment configurer l’intégration APM et les certificats d’autorité de certification.

Le tableau suivant répertorie les fournisseurs APM disponibles pour les plans.

Plan Standard	Plan Entreprise
Insights sur l’application New Relic DynaTrace AppDynamics	Insights sur l’application New Relic DynaTrace AppDynamics ElasticAPM

Azure portal

Pour vérifier ou mettre à jour les paramètres actuels dans Application Insights, procédez comme suit :

1. Dans votre instance Azure Spring Apps Enterprise, sélectionnez Application Recommandations.

2. Activez ou désactivez l’Recommandations d’application en sélectionnant Modifier la liaison ou annuler la liaison.

   

3. Sélectionnez Modifier la liaison. Modifiez les paramètres de liaison, puis sélectionnez Enregistrer.

   

Azure CLI

Les commandes suivantes vous montrent comment case activée ou mettre à jour les paramètres actuels dans application Recommandations.

Utilisez la commande suivante pour créer une liaison d’application Recommandations buildpack :

az spring build-service builder buildpack-binding create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Utilisez la commande suivante pour répertorier toutes les liaisons buildpack et rechercher les liaisons d’application Recommandations pour le type ApplicationInsights:

az spring build-service builder buildpack-binding list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --builder-name <your-builder-name>

Utilisez la commande suivante pour remplacer une liaison d’application Recommandations buildpack :

az spring build-service builder buildpack-binding set \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Utilisez la commande suivante pour obtenir une liaison d’application Recommandations buildpack :

az spring build-service builder buildpack-binding show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

Utilisez la commande suivante pour supprimer une liaison d’application Recommandations buildpack :

az spring build-service builder buildpack-binding delete \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

Pour plus d’informations, consultez Utiliser l’agent in-process Java d’Application Insights dans Azure Spring Apps.

Étapes suivantes

• Azure Spring Apps
• Utiliser le portail des API pour VMware Tanzu
• Utiliser Spring Cloud Gateway