Partager via

Démarrage rapide : Intégrer Azure Spring Apps à Azure Database pour MySQL

  • Article

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 à : ✔️ De base/Standard ❌ Entreprise

Pet Clinic, tel que déployé dans la configuration par défaut dans Démarrage rapide : Créer et déployer des applications sur Azure Spring Apps, utilise une base de données en mémoire (HSQLDB) qui est remplie avec les données au démarrage. Ce guide de démarrage rapide explique comment provisionner et préparer une instance Azure Database pour MySQL, puis comment configurer Pet Clinic sur Azure Spring Apps pour l’utiliser comme base de données persistante.

Prérequis

Compte Azure avec un abonnement actif. Créez un compte gratuitement.

Créer une instance Azure Database pour MySQL

Créez un serveur flexible Azure Database pour MySQL à l’aide de la commande az mysql flexible-server create. Remplacez les espaces réservés <database-name>, <resource-group-name>, <MySQL-flexible-server-name>, <admin-username> et <admin-password> par un nom pour votre nouvelle base de données, le nom de votre groupe de ressources, un nom pour votre nouveau serveur, ainsi qu’un nom d’utilisateur et un mot de passe d’administrateur. Utilisez des guillemets uniques autour de la valeur admin-password.

az mysql flexible-server create \
    --resource-group <resource-group-name> \
    --name <MySQL-flexible-server-name> \
    --database-name <database-name> \
    --public-access 0.0.0.0 \
    --admin-user <admin-username> \
    --admin-password '<admin-password>'

Notes

La référence SKU Standard_B1ms est utilisée par défaut. Pour plus d’informations sur la tarification, consultez la Tarification Azure Database pour MySQL.

Conseil

Le mot de passe doit compter au moins huit caractères et contenir au moins une lettre majuscule, une lettre minuscule sans signe diacritique, un chiffre et un caractère non alphanumérique (!, $, #,%, etc.).

Connecter votre application à la base de données MySQL

Utilisez un connecteur de services pour connecter l’application hébergée dans Azure Spring Apps à votre base de données MySQL.

Notes

La fonctionnalité de liaison de service dans Azure Spring Apps est déconseillée au profit d’un connecteur de services.

  1. Si vous utilisez Service Connector pour la première fois, commencez par exécuter la commande az provider register pour inscrire le fournisseur de ressources Service Connector.

    az provider register --namespace Microsoft.ServiceLinker

  2. Exécutez la commande az spring connection create pour créer une connexion de service entre l’application customers-service et la base de données Azure MySQL. Remplacez les espaces réservés pour les paramètres suivants par vos propres informations. Utilisez des guillemets uniques autour de la valeur du serveur MySQL secret.

    Paramètre Description
    --connection Le nom de la connexion qui identifie la connexion entre votre instance d’application et le service cible.
    --resource-group Nom du groupe de ressources contenant l’application hébergée par Azure Spring Apps.
    --service Le nom de la ressource Azure Spring Apps.
    --app Nom de l’application hébergée par Azure Spring Apps qui se connecte au service cible.
    --target-resource-group Le nom du groupe de ressources avec le compte de stockage.
    --server Serveur MySQL auquel vous souhaitez vous connecter
    --database Nom de la base de données que vous avez créée précédemment.
    --secret name= secret= Les nom d’utilisateur et mot de passe du serveur MySQL. 
    az spring connection create mysql-flexible \
    --resource-group <Azure-Spring-Apps-resource-group-name> \
    --service <Azure-Spring-Apps-resource-name> \
    --app customers-service \
    --connection <mysql-connection-name-for-app> \
    --target-resource-group <mySQL-server-resource-group> \
    --server <server-name> \
    --database <database-name> \
    --secret name=<username> secret='<secret>'

    Conseil

    Si le système ne reconnaît pas la commande az spring, vérifiez que vous avez installé l’extension Azure Spring Apps en exécutant az extension add --name spring.

Répétez ces étapes pour créer des connexions pour les applications customers-service, vets-service et visits-service.

Vérifier la connexion à la base de données MySQL

Exécutez la commande az spring connection validate pour afficher l’état de la connexion entre l’application customers-service et la base de données Azure MySQL. Remplacez les espaces réservés par vos propres informations.

az spring connection validate \
    --resource-group <Azure-Spring-Apps-resource-group-name> \
    --service <Azure-Spring-Apps-resource-name> \
    --app customers-service \
    --connection <mysql-connection-name-for-app> \
    --output table

Vous obtenez la sortie suivante :

Name                                  Result    Description
------------------------------------  --------  -------------
Target resource existence validated.  success
Target service firewall validated.    success
Username and password validated.      success

Conseil

Pour obtenir plus d’informations sur la connexion entre vos services, supprimez --output table de la commande ci-dessus.

Répétez ces instructions pour valider les connexions pour les applications customers-service, vets-serviceet visits-service.

Mettre à jour les applications pour utiliser le profil MySQL

La section suivante explique comment mettre à jour les applications pour se connecter à la base de données MySQL.

Utilisez la commande suivante pour définir une variable d’environnement afin d’activer le profil mysql de l’application customers-service :

az spring app update \
    --resource-group <Azure-Spring-Apps-resource-group-name> \
    --service <Azure-Spring-Apps-resource-name> \
    --name customers-service \
    --env SPRING_PROFILES_ACTIVE=mysql

Répétez ces instructions pour mettre à jour la configuration de l’application pour les applications customers-service, vets-serviceet visits-service.

Valider les applications

Pour valider le service Pet Clinic et interroger les enregistrements de la base de données MySQL afin de confirmer la connexion à la base de données, suivez les instructions de la section Vérifier les services de Démarrage rapide : créer et déployer des applications sur Azure Spring Apps.

Nettoyer les ressources

Si vous prévoyez d’utiliser d’autres guides de démarrage rapide et tutoriels, vous pouvez conserver ces ressources. Quand vous n’en avez plus besoin, supprimez le groupe de ressources à l’aide de la commande az group delete qui supprime les ressources du groupe de ressources. Remplacez <resource-group> par le nom de votre groupe de ressources.

az group delete --name <resource-group>

Étapes suivantes