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 à : ✔️ Consommation Standard et dédiée (préversion) ✔️ De base/Standard ✔️ Entreprise
Cet article explique comment déployer une application basée sur les événements Spring Boot sur Azure Spring Apps.
L’exemple de projet est une application basée sur les événements qui s’abonne à une file d’attente Service Bus nommée lower-case, puis gère le message et envoie un autre message à une autre file d’attente nommée upper-case. Pour simplifier l’application, le traitement des messages convertit simplement le message en majuscules. Le diagramme suivant illustre ce processus :
Cet article fournit les options suivantes pour le déploiement sur Azure Spring Apps :
L’option Portail Azure est la méthode la plus simple et la plus rapide pour créer des ressources et déployer des applications en un seul clic. Cette option convient aux développeurs Spring qui souhaitent déployer rapidement des applications sur des services cloud Azure.
L'option Portail Azure + Plugin Maven est un moyen plus conventionnel de créer des ressources et de déployer des applications étape par étape. Cette option convient aux développeurs Spring qui utilisent les services cloud Azure pour la première fois.
L’option Azure Developer CLI est un moyen plus efficace de créer automatiquement des ressources et de déployer des applications par le biais de commandes simples. Azure Developer CLI utilise un modèle pour provisionner les ressources Azure nécessaires et déployer le code de l’application. Cette option convient aux développeurs Spring qui sont familiarisés avec les services cloud Azure.
L'option du Portail Azure constitue le moyen le plus simple et le plus rapide de créer des ressources et de déployer des applications en un seul clic. Cette option convient aux développeurs Spring qui souhaitent déployer rapidement des applications sur des services cloud Azure.
L'option Portail Azure + Plugin Maven est un moyen plus conventionnel de créer des ressources et de déployer des applications étape par étape. Cette option convient aux développeurs Spring qui utilisent les services cloud Azure pour la première fois.
L'option Azure CLI utilise un puissant outil de ligne de commande pour gérer les ressources Azure. Cette option convient aux développeurs Spring qui sont familiarisés avec les services cloud Azure.
Le bouton Déployer sur Azure dans la section suivante lance une expérience du portail Azure qui télécharge un package JAR à partir de la page des versions ASA-Samples-Web-Application sur GitHub. Aucune étape de préparation locale n’est nécessaire.
Utilisez les étapes suivantes pour préparer l’exemple localement :
L’exemple de projet est prêt sur GitHub. Clonez l’exemple de projet à l’aide de la commande suivante :
Générez l’exemple de projet à l’aide des commandes suivantes :
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
Utilisez les étapes suivantes pour préparer l’exemple localement. Ces étapes utilisent AZD pour initialiser l’application basée sur les événements à partir des modèles Azure Developer CLI.
Ouvrez un terminal, créez un dossier vide, puis accédez-y.
Utilisez la commande ci-dessous pour initialiser le projet :
La liste suivante décrit les interactions de commande :
Entrez un nouveau nom d’environnement : fournissez un nom d’environnement, qui est utilisé comme suffixe pour le groupe de ressources créé pour contenir toutes les ressources Azure. Ce nom doit être unique dans votre abonnement Azure.
La console génère des messages similaires à l’exemple suivant :
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Préparer l’environnement cloud
Les principales ressources dont vous avez besoin pour exécuter cet exemple sont une instance Azure Spring Apps, une instance Azure Key Vault et une instance Azure Service Bus. Exécutez les étapes suivantes pour créer ces ressources.
Cette section utilise un bouton Déployer sur Azure pour lancer une expérience de déploiement dans le portail Azure. Cette expérience utilise un modèle ARM pour créer des ressources Azure.
3.1. Connectez-vous au portail Azure.
Accédez au Portail Microsoft Azure et entrez vos informations d’identification pour vous connecter au portail. Il s’ouvre par défaut sur le tableau de bord des services.
3.2. Créer des ressources Azure
Pour créer toutes les ressources Azure dont dépend l’application, procédez comme suit :
Sélectionnez le bouton Déployer sur Azure suivant pour lancer l’expérience de déploiement dans le Portail Microsoft Azure :
Renseignez le formulaire dans l’onglet Informations de base. Utilisez le tableau suivant comme guide afin de remplir le formulaire :
Paramètre
Valeur suggérée
Description
Abonnement
Nom de votre abonnement.
Abonnement Azure que vous souhaitez utiliser pour votre serveur. Si vous disposez de plusieurs abonnements, choisissez celui dans lequel vous souhaitez que la ressource soit facturée.
Groupe de ressources
myresourcegroup
Un nouveau nom de groupe de ressources ou un nom de groupe existant dans votre abonnement.
Région
La région la plus proche de vos utilisateurs.
La région est utilisée pour créer le groupe de ressources.
Sélectionnez Vérifier et créer pour passer en revue vos sélections. Ensuite, sélectionnez Créer pour déployer l’application sur Azure Spring Apps.
Dans la barre d’outils, sélectionnez l’icône Notifications (en forme de cloche) pour surveiller le processus de déploiement. Une fois le déploiement terminé, vous pouvez sélectionner Épingler au tableau de bord, ce qui crée une vignette pour ce service dans votre tableau de bord du Portail Microsoft Azure, en tant que raccourci vers la page Vue d’ensemble du service. Sélectionnez Accéder à la ressource pour ouvrir la page Vue d’ensemble du service.
3.1. Connectez-vous au portail Azure.
Ouvrez votre navigateur web pour accéder au Portail Azure. Entrez vos informations d’identification pour vous connecter au portail. Il s’ouvre par défaut sur le tableau de bord des services.
3.2. Créer une instance Service Bus
Utilisez la procédure suivante pour créer une instance Service Bus :
Sélectionnez Créer une ressource dans le coin du portail Azure.
Dans la zone de recherche Rechercher dans les services et la Place de marché, recherchez service bus.
Dans la section Service Bus, sélectionnez Créer.
Renseignez le formulaire dans l’onglet Informations de base. Utilisez le tableau suivant comme guide afin de remplir le formulaire :
Paramètre
Valeur suggérée
Description
Abonnement
Nom de votre abonnement.
Abonnement Azure que vous souhaitez utiliser pour votre serveur. Si vous disposez de plusieurs abonnements, choisissez celui dans lequel vous souhaitez que la ressource soit facturée.
Groupe de ressources
myresourcegroup
Un nouveau nom de groupe de ressources ou un nom de groupe existant dans votre abonnement.
Nom de l’espace de noms
my-srvbus
Nom unique qui identifie votre service Service Bus.
Lieu
Emplacement le plus proche de vos utilisateurs.
L’emplacement géographique le plus proche de vos utilisateurs.
Options et plans d’hébergement
De base
Le plan tarifaire détermine les ressources et le coût associés à votre instance.
Sélectionnez Vérifier et Créer pour passer en revue les paramètres de création. Ensuite, sélectionnez Créer pour terminer la création de l’instance Service Bus.
Dans la barre d’outils, sélectionnez l’icône Notifications (en forme de cloche) pour surveiller le processus de déploiement. Une fois le déploiement terminé, vous pouvez sélectionner Épingler au tableau de bord, ce qui crée une vignette pour ce service dans votre tableau de bord du Portail Microsoft Azure, en tant que raccourci vers la page Vue d’ensemble du service. Sélectionnez Accéder à la ressource pour ouvrir la page Vue d’ensemble du service.
Sélectionnez Accéder à la ressource pour accéder à la page Espace de noms Service Bus.
Sélectionnez Stratégies d'accès partagé dans le menu de navigation, puis sélectionnez RootManageSharedAccessKey.
Sur la page Stratégie SAP : RootManageSharedAccessKey, copiez et enregistrez la valeur Chaîne de connexion principale, qui sert à configurer les connexions à partir de l’application Spring.
Sélectionnez Files d'attente dans le menu de navigation, puis sélectionnez File d'attente.
Sur la page Créer une file d'attente, saisissez des minuscules pour Nom, puis sélectionnez Créer.
Créez une autre file d'attente en répétant l'étape précédente en utilisant des majuscules pour Nom.
3.3. Créer une instance Azure Spring Apps
Utilisez la procédure suivante pour créer une instance de service :
Sélectionnez Créer une ressource dans le coin du portail.
Sélectionnez Calcul>Azure Spring Apps.
Remplissez le formulaire Consommation standard et dédiée (préversion) avec les informations suivantes :
Paramètre
Valeur suggérée
Description
Abonnement
Votre nom d’abonnement
Abonnement Azure que vous souhaitez utiliser pour votre serveur. Si vous disposez de plusieurs abonnements, choisissez celui dans lequel vous souhaitez que la ressource soit facturée.
Groupe de ressources
myresourcegroup
Un nouveau nom de groupe de ressources ou un nom de groupe existant dans votre abonnement.
Nom
myasa
Nom unique qui identifie votre instance Azure Spring Apps. Le nom doit comporter entre 4 et 32 caractères, et 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.
Planification
Consommation standard et dédiée (préversion)
Le plan tarifaire détermine les ressources et le coût associés à votre instance.
Région
La région la plus proche de vos utilisateurs
L’emplacement géographique le plus proche de vos utilisateurs.
Environnement Container Apps
myacaenv
L’environnement est une limite sécurisée autour d’une ou plusieurs applications conteneur, qui peuvent communiquer entre elles et partager un réseau virtuel, une journalisation et une configuration Dapr.
(Facultatif) Procédez comme suit pour créer un environnement Container Apps :
Renseignez l’onglet Informations de base avec les informations suivantes :
Nom de l’environnement : myacaenv
Plan : Consommation
Redondance de zone : désactivée
Sélectionnez Créer pour créer l’Environnement Container Apps.
Renseignez l’onglet Informations de base avec les informations suivantes :
Nom de l’environnement : myacaenv
Plan : (préversion) Consommation et profils de charge de travail dédiés
Redondance de zone : désactivée
Sélectionnez l’onglet Profils de charge de travail (préversion), puis sélectionnez Ajouter un profil de charge de travail pour ajouter un profil de charge de travail.
Dans la page Ajouter un profil de charge de travail (préversion), ajoutez les informations suivantes :
Nom du profil de charge de travail : my-wlp
Taille du profil de charge de travail : sélectionnez Dedicated-D4
Plage de nombre d’instances en mise à l’échelle automatique : sélectionnez 3 et 5
Sélectionnez Ajouter. Cette sélection vous ramène à la page Ajouter un profil de charge de travail (préversion). Sélectionnez my-wlp puis Créer pour créer l’Environnement Container Apps.
Sélectionnez Vérifier et créer pour passer en revue vos sélections. Sélectionnez Créer pour approvisionner l’instance Azure Spring Apps.
Dans la barre d’outils, sélectionnez l’icône Notifications (en forme de cloche) pour surveiller le processus de déploiement. Une fois le déploiement terminé, vous pouvez sélectionner Épingler au tableau de bord, ce qui crée une vignette pour ce service dans votre tableau de bord du portail Azure, en tant que raccourci vers la page Vue d’ensemble du service. Sélectionnez Accéder à la ressource pour ouvrir la page Vue d’ensemble du service.
Sélectionnez Accéder à la ressource pour accéder à la page Vue d’ensemble d’Azure Spring Apps.
Sélectionnez Applications dans le menu de navigation de gauche, puis Créer une application.
Dans la page Créer une application, saisissez simple-event-driven-app pour le Nom de l’application, puis sélectionnez Utiliser l’exemple d’application de démarrage rapide pour créer l’application.
Sélectionnez Créer pour terminer la création de l’instance Azure Spring Apps.
Après avoir créé l’application, sélectionnez le nom de l’application créé à l’étape précédente.
Sélectionnez Configuration dans le volet de navigation, puis configurez les propriétés suivantes sous l’onglet Variables d’environnement.
SERVICE_BUS_CONNECTION_STRING : entrez la chaîne de connexion principale Service Bus.
Sélectionnez Enregistrer pour enregistrer les propriétés de la connexion.
Utilisez la commande suivante pour vous connecter à Azure avec OAuth2. Ignorez cette étape si vous êtes déjà connecté.
azd auth login
La console génère des messages similaires à l’exemple suivant :
Logged in to Azure.
Utilisez la commande suivante pour approvisionner l’infrastructure du modèle sur Azure :
azd provision
La liste suivante décrit les interactions de commande :
Sélectionnez un abonnement Azure à utiliser : utilisez les flèches pour vous déplacer, tapez pour filtrer, puis appuyez sur Entrée.
Sélectionnez un emplacement Azure à utiliser : utilisez les flèches pour vous déplacer, tapez pour filtrer, puis appuyez sur Entrée.
La console génère des messages similaires à l’exemple suivant :
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Remarque
Cette commande peut prendre un certain temps. Un indicateur de progression s’affiche au fur et à mesure de l’approvisionnement des ressources Azure.
Le bouton Déployer sur Azure dans la section précédente lance une expérience du portail Azure qui inclut le déploiement d’applications. Vous n’avez donc rien d’autre à faire.
La liste suivante décrit les interactions de commande :
Connexion OAuth2 : vous devez autoriser la connexion à Azure en fonction du protocole OAuth2.
Sélectionnez un abonnement : sélectionnez le numéro de liste d’abonnements de l’instance Azure Spring Apps créée, qui correspond par défaut au premier abonnement de la liste. Si vous utilisez le nombre par défaut, appuyez directement sur Entrée.
Utiliser Azure Spring Apps dans Azure : appuyez sur y (oui) pour utiliser l’instance Azure Spring Apps existante.
Sélectionnez Azure Spring Apps pour le déploiement : sélectionnez le numéro de liste de l’instance Azure Spring Apps que vous avez créée. Si vous utilisez le nombre par défaut, appuyez directement sur Entrée.
Utiliser l’application existante dans Azure Spring Apps <your-instance-name> : appuyez sur y (oui) pour utiliser l’application créée.
Confirmez pour enregistrer toutes les configurations ci-dessus : appuyez sur y (oui). Si vous entrez N, la configuration n’est pas enregistrée dans les fichiers POM.
Utilisez la commande suivante pour déployer l’application :
./mvnw azure-spring-apps:deploy
La liste suivante décrit l’interaction de commande :
Connexion OAuth2 : vous devez autoriser la connexion à Azure en fonction du protocole OAuth2.
Une fois la commande exécutée, les messages de journal suivants indiquent que le déploiement a réussi :
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
Utilisez la procédure ci-dessous pour utiliser AZD pour empaqueter l’application, approvisionner les ressources Azure requises par l’application web, puis effectuer le déploiement sur Azure Spring Apps.
Utilisez la commande suivante pour empaqueter une copie déployable de votre application :
azd package
La console génère des messages similaires à l’exemple suivant :
SUCCESS: Your application was packaged for Azure in xx seconds.
Utilisez la commande suivante pour déployer le code d’application sur les nouvelles ressources approvisionnées :
azd deploy
La console génère des messages similaires à l’exemple suivant :
Deploying services (azd deploy)
(✓) Done: Deploying service simple-event-driven-app
- No endpoints were found
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Remarque
Vous pouvez également utiliser azd up pour combiner les trois commandes précédentes : azd provision (approvisionne les ressources Azure), azd package (empaquette une copie déployable de votre application) et azd deploy (déploie le code de l’application). Pour plus d’informations, consultez la page Azure-Samples/ASA-Samples-Event-Driver-Application.
Le bouton Déployer sur Azure dans la section suivante lance une expérience du portail Azure qui télécharge un package JAR à partir de la page des versions ASA-Samples-Web-Application sur GitHub. Aucune étape de préparation locale n’est nécessaire.
Utilisez les étapes suivantes pour préparer l’exemple localement :
L’exemple de projet est prêt sur GitHub. Clonez l’exemple de projet à l’aide de la commande suivante :
Générez l’exemple de projet à l’aide des commandes suivantes :
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
Utilisez les étapes suivantes pour préparer l’exemple localement. Ces étapes utilisent AZD pour initialiser l’application basée sur les événements à partir des modèles Azure Developer CLI.
Ouvrez un terminal, créez un dossier vide, puis accédez-y.
Utilisez la commande ci-dessous pour initialiser le projet :
La liste suivante décrit les interactions de commande :
Entrez un nouveau nom d’environnement : fournissez un nom d’environnement, qui est utilisé comme suffixe pour le groupe de ressources créé pour contenir toutes les ressources Azure. Ce nom doit être unique dans votre abonnement Azure.
La console génère des messages similaires à l’exemple suivant :
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Préparer l’environnement cloud
Les principales ressources dont vous avez besoin pour exécuter cet exemple sont une instance Azure Spring Apps, une instance Azure Key Vault et une instance Azure Service Bus. Exécutez les étapes suivantes pour créer ces ressources.
Cette section utilise un bouton Déployer sur Azure pour lancer une expérience de déploiement dans le portail Azure. Cette expérience utilise un modèle ARM pour créer des ressources Azure.
3.1. Connectez-vous au portail Azure.
Accédez au Portail Microsoft Azure et entrez vos informations d’identification pour vous connecter au portail. Il s’ouvre par défaut sur le tableau de bord des services.
3.2. Créer des ressources Azure
Pour créer toutes les ressources Azure dont dépend l’application, procédez comme suit :
Sélectionnez le bouton Déployer sur Azure suivant pour lancer l’expérience de déploiement dans le Portail Microsoft Azure :
Renseignez le formulaire dans l’onglet Informations de base. Utilisez le tableau suivant comme guide afin de remplir le formulaire :
Paramètre
Valeur suggérée
Description
Abonnement
Nom de votre abonnement.
Abonnement Azure que vous souhaitez utiliser pour votre serveur. Si vous disposez de plusieurs abonnements, choisissez celui dans lequel vous souhaitez que la ressource soit facturée.
Groupe de ressources
myresourcegroup
Un nouveau nom de groupe de ressources ou un nom de groupe existant dans votre abonnement.
Région
La région la plus proche de vos utilisateurs.
La région est utilisée pour créer le groupe de ressources.
Sélectionnez Vérifier et créer pour passer en revue vos sélections. Ensuite, sélectionnez Créer pour déployer l’application sur Azure Spring Apps.
Dans la barre d’outils, sélectionnez l’icône Notifications (en forme de cloche) pour surveiller le processus de déploiement. Une fois le déploiement terminé, vous pouvez sélectionner Épingler au tableau de bord, ce qui crée une vignette pour ce service dans votre tableau de bord du Portail Microsoft Azure, en tant que raccourci vers la page Vue d’ensemble du service. Sélectionnez Accéder à la ressource pour ouvrir la page Vue d’ensemble du service.
3.1. Connectez-vous au portail Azure.
Ouvrez votre navigateur web pour accéder au Portail Azure. Entrez vos informations d’identification pour vous connecter au portail. Il s’ouvre par défaut sur le tableau de bord des services.
3.2. Créer une instance Service Bus
Utilisez la procédure suivante pour créer une instance Service Bus :
Sélectionnez Créer une ressource dans le coin du portail Azure.
Dans la zone de recherche Rechercher dans les services et la Place de marché, recherchez service bus.
Dans la section Service Bus, sélectionnez Créer.
Renseignez le formulaire dans l’onglet Informations de base. Utilisez le tableau suivant comme guide afin de remplir le formulaire :
Paramètre
Valeur suggérée
Description
Abonnement
Nom de votre abonnement.
Abonnement Azure que vous souhaitez utiliser pour votre serveur. Si vous disposez de plusieurs abonnements, choisissez celui dans lequel vous souhaitez que la ressource soit facturée.
Groupe de ressources
myresourcegroup
Un nouveau nom de groupe de ressources ou un nom de groupe existant dans votre abonnement.
Nom de l’espace de noms
my-srvbus
Nom unique qui identifie votre service Service Bus.
Lieu
Emplacement le plus proche de vos utilisateurs.
L’emplacement géographique le plus proche de vos utilisateurs.
Options et plans d’hébergement
De base
Le plan tarifaire détermine les ressources et le coût associés à votre instance.
Sélectionnez Vérifier et Créer pour passer en revue les paramètres de création. Ensuite, sélectionnez Créer pour terminer la création de l’instance Service Bus.
Dans la barre d’outils, sélectionnez l’icône Notifications (en forme de cloche) pour surveiller le processus de déploiement. Une fois le déploiement terminé, vous pouvez sélectionner Épingler au tableau de bord, ce qui crée une vignette pour ce service dans votre tableau de bord du Portail Microsoft Azure, en tant que raccourci vers la page Vue d’ensemble du service. Sélectionnez Accéder à la ressource pour ouvrir la page Vue d’ensemble du service.
Sélectionnez Accéder à la ressource pour accéder à la page Espace de noms Service Bus.
Sélectionnez Stratégies d'accès partagé dans le menu de navigation, puis sélectionnez RootManageSharedAccessKey.
Sur la page Stratégie SAP : RootManageSharedAccessKey, copiez et enregistrez la valeur Chaîne de connexion principale, qui sert à configurer les connexions à partir de l’application Spring.
Sélectionnez Files d'attente dans le menu de navigation, puis sélectionnez File d'attente.
Sur la page Créer une file d'attente, saisissez des minuscules pour Nom, puis sélectionnez Créer.
Créez une autre file d'attente en répétant l'étape précédente en utilisant des majuscules pour Nom.
3.3. Créer une instance Azure Spring Apps
Utilisez les étapes suivantes pour créer une instance Azure Spring Apps :
Sélectionnez Créer une ressource dans le coin du portail Azure.
Sélectionnez Calcul>Azure Spring Apps.
Remplissez le formulaire Informations de base avec les informations suivantes :
Utilisez le tableau suivant comme guide afin de remplir le formulaire. Le plan recommandé est Standard.
Paramètre
Valeur suggérée
Description
Abonnement
Votre nom d’abonnement
Abonnement Azure que vous souhaitez utiliser pour votre serveur. Si vous disposez de plusieurs abonnements, choisissez celui dans lequel vous souhaitez que la ressource soit facturée.
Groupe de ressources
myresourcegroup
Un nouveau nom de groupe de ressources ou un nom de groupe existant dans votre abonnement.
Nom
myasa
Nom unique qui identifie votre instance Azure Spring Apps. Le nom doit comporter entre 4 et 32 caractères, et 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.
Planification
Standard
Le plan détermine la ressource et le coût associés à votre instance.
Région
La région la plus proche de vos utilisateurs
L’emplacement géographique le plus proche de vos utilisateurs.
Redondant interzone
Désactivé
Si vous créez votre service Azure Spring Apps dans une zone de disponibilité Azure, cela n’est pris en charge que dans plusieurs régions pour le moment.
Sélectionnez Vérifier et créer pour passer en revue vos sélections. Sélectionnez Créer pour approvisionner l’instance Azure Spring Apps.
Dans la barre d’outils, sélectionnez l’icône Notifications (en forme de cloche) pour surveiller le processus de déploiement. Une fois le déploiement terminé, vous pouvez sélectionner Épingler au tableau de bord, ce qui crée une vignette pour ce service dans votre tableau de bord du portail Azure, en tant que raccourci vers la page Vue d’ensemble du service. Sélectionnez Accéder à la ressource pour ouvrir la page Vue d’ensemble du service.
3.4. Connecter l’instance d’application à l’instance Service Bus
Accédez à votre instance Azure Spring Apps dans le portail Azure.
Sélectionnez Applications dans le menu de navigation, puis Créer une application.
Sur la page Créer une application, entrez le nom d’applicationsimple-event-driven-app, puis sélectionnez la plateforme d’exécutionJava 17.
Après avoir créé l’application, sélectionnez le nom de l’application créé à l’étape précédente.
Sur la page Configuration, sélectionnez l’onglet Variables d’environnement, entrez la cléSERVICE_BUS_CONNECTION_STRING, collez la chaîne de connexion Service Bus comme valeur, puis sélectionnez Enregistrer.
Utilisez la commande suivante pour vous connecter à Azure avec OAuth2. Ignorez cette étape si vous êtes déjà connecté.
azd auth login
La console génère des messages similaires à l’exemple suivant :
Logged in to Azure.
Utilisez la commande suivante pour définir le modèle à l’aide du plan Standard :
azd env set PLAN standard
Utilisez la commande suivante pour empaqueter une copie déployable de votre application, approvisionner l’infrastructure du modèle sur Azure et déployer le code de l’application sur les nouvelles ressources approvisionnées :
azd provision
La liste suivante décrit les interactions de commande :
Sélectionnez un abonnement Azure à utiliser : utilisez les flèches pour vous déplacer, tapez pour filtrer, puis appuyez sur Entrée.
Sélectionnez un emplacement Azure à utiliser : utilisez les flèches pour vous déplacer, tapez pour filtrer, puis appuyez sur Entrée.
La console génère des messages similaires à l’exemple suivant :
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Remarque
Cette commande peut prendre un certain temps. Un indicateur de progression s’affiche au fur et à mesure de l’approvisionnement des ressources Azure.
Le bouton Déployer sur Azure dans la section précédente lance une expérience du portail Azure qui inclut le déploiement d’applications. Vous n’avez donc rien d’autre à faire.
La liste suivante décrit les interactions de commande :
Connexion OAuth2 : vous devez autoriser la connexion à Azure en fonction du protocole OAuth2.
Sélectionnez un abonnement : sélectionnez le numéro de liste d’abonnements de l’instance Azure Spring Apps créée, qui correspond par défaut au premier abonnement de la liste. Si vous utilisez le nombre par défaut, appuyez directement sur Entrée.
Utiliser Azure Spring Apps dans Azure : appuyez sur y (oui) pour utiliser l’instance Azure Spring Apps existante.
Sélectionnez Azure Spring Apps pour le déploiement : sélectionnez le numéro de liste de l’instance Azure Spring Apps que vous avez créée. Si vous utilisez le nombre par défaut, appuyez directement sur Entrée.
Utiliser l’application existante dans Azure Spring Apps <your-instance-name> : appuyez sur y (oui) pour utiliser l’application créée.
Confirmez pour enregistrer toutes les configurations ci-dessus : appuyez sur y (oui). Si vous entrez N, la configuration n’est pas enregistrée dans les fichiers POM.
Utilisez la commande suivante pour déployer l’application :
./mvnw azure-spring-apps:deploy
La liste suivante décrit l’interaction de commande :
Connexion OAuth2 : vous devez autoriser la connexion à Azure en fonction du protocole OAuth2.
Une fois la commande exécutée, les messages de journal suivants indiquent que le déploiement a réussi :
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
Utilisez la procédure ci-dessous pour utiliser AZD pour empaqueter l’application, approvisionner les ressources Azure requises par l’application web, puis effectuer le déploiement sur Azure Spring Apps.
Utilisez la commande suivante pour empaqueter une copie déployable de votre application :
azd package
La console génère des messages similaires à l’exemple suivant :
SUCCESS: Your application was packaged for Azure in xx seconds.
Utilisez la commande suivante pour déployer le code d’application sur les nouvelles ressources approvisionnées :
azd deploy
La console génère des messages similaires à l’exemple suivant :
Deploying services (azd deploy)
(✓) Done: Deploying service simple-event-driven-app
- No endpoints were found
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Remarque
Vous pouvez également utiliser azd up pour combiner les trois commandes précédentes : azd provision (approvisionne les ressources Azure), azd package (empaquette une copie déployable de votre application) et azd deploy (déploie le code de l’application). Pour plus d’informations, consultez la page Azure-Samples/ASA-Samples-Event-Driver-Application.
Le bouton Déployer sur Azure dans la section suivante lance une expérience du portail Azure qui télécharge un package JAR à partir de la page des versions ASA-Samples-Web-Application sur GitHub. Aucune étape de préparation locale n’est nécessaire.
Utilisez les étapes suivantes pour préparer l’exemple localement :
L’exemple de projet est prêt sur GitHub. Clonez l’exemple de projet à l’aide de la commande suivante :
Générez l’exemple de projet à l’aide des commandes suivantes :
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
3. Préparer l’environnement cloud
Les principales ressources dont vous avez besoin pour exécuter cet exemple sont une instance Azure Spring Apps et une instance Azure Service Bus. Dans les sections suivantes, découvrez comment créer ces ressources.
Cette section utilise un bouton Déployer sur Azure pour lancer une expérience de déploiement dans le portail Azure. Cette expérience utilise un modèle ARM pour créer des ressources Azure.
3.1. Connectez-vous au portail Azure.
Accédez au Portail Microsoft Azure et entrez vos informations d’identification pour vous connecter au portail. Il s’ouvre par défaut sur le tableau de bord des services.
3.2. Créer des ressources Azure
Pour créer toutes les ressources Azure dont dépend l’application, procédez comme suit :
Sélectionnez le bouton Déployer sur Azure suivant pour lancer l’expérience de déploiement dans le Portail Microsoft Azure :
Renseignez le formulaire dans l’onglet Informations de base. Utilisez le tableau suivant comme guide afin de remplir le formulaire :
Paramètre
Valeur suggérée
Description
Abonnement
Nom de votre abonnement.
Abonnement Azure que vous souhaitez utiliser pour votre serveur. Si vous disposez de plusieurs abonnements, choisissez celui dans lequel vous souhaitez que la ressource soit facturée.
Groupe de ressources
myresourcegroup
Un nouveau nom de groupe de ressources ou un nom de groupe existant dans votre abonnement.
Région
La région la plus proche de vos utilisateurs.
La région est utilisée pour créer le groupe de ressources.
Sélectionnez Vérifier et créer pour passer en revue vos sélections. Ensuite, sélectionnez Créer pour déployer l’application sur Azure Spring Apps.
Dans la barre d’outils, sélectionnez l’icône Notifications (en forme de cloche) pour surveiller le processus de déploiement. Une fois le déploiement terminé, vous pouvez sélectionner Épingler au tableau de bord, ce qui crée une vignette pour ce service dans votre tableau de bord du Portail Microsoft Azure, en tant que raccourci vers la page Vue d’ensemble du service. Sélectionnez Accéder à la ressource pour ouvrir la page Vue d’ensemble du service.
3.1. Connectez-vous au portail Azure.
Accédez au Portail Microsoft Azure et entrez vos informations d’identification pour vous connecter au portail. Il s’ouvre par défaut sur le tableau de bord des services.
3.2. Créer une instance Service Bus
Utilisez la procédure suivante pour créer une instance Service Bus :
Sélectionnez Créer une ressource dans le coin du portail Azure.
Dans la zone de recherche Rechercher dans les services et la Place de marché, recherchez service bus.
Dans la section Service Bus, sélectionnez Créer.
Renseignez le formulaire dans l’onglet Informations de base. Utilisez le tableau suivant comme guide afin de remplir le formulaire :
Paramètre
Valeur suggérée
Description
Abonnement
Nom de votre abonnement.
Abonnement Azure que vous souhaitez utiliser pour votre serveur. Si vous disposez de plusieurs abonnements, choisissez celui dans lequel vous souhaitez que la ressource soit facturée.
Groupe de ressources
myresourcegroup
Un nouveau nom de groupe de ressources ou un nom de groupe existant dans votre abonnement.
Nom de l’espace de noms
my-srvbus
Nom unique qui identifie votre service Service Bus.
Lieu
Emplacement le plus proche de vos utilisateurs.
L’emplacement géographique le plus proche de vos utilisateurs.
Options et plans d’hébergement
De base
Le plan tarifaire détermine les ressources et le coût associés à votre instance.
Sélectionnez Vérifier et Créer pour passer en revue les paramètres de création. Ensuite, sélectionnez Créer pour terminer la création de l’instance Service Bus.
Dans la barre d’outils, sélectionnez l’icône Notifications (en forme de cloche) pour surveiller le processus de déploiement. Une fois le déploiement terminé, vous pouvez sélectionner Épingler au tableau de bord, ce qui crée une vignette pour ce service dans votre tableau de bord du Portail Microsoft Azure, en tant que raccourci vers la page Vue d’ensemble du service. Sélectionnez Accéder à la ressource pour ouvrir la page Vue d’ensemble du service.
Sélectionnez Accéder à la ressource pour accéder à la page Espace de noms Service Bus.
Sélectionnez Files d’attente dans le menu de navigation, puis sélectionnez File d’attente.
Sur la page Créer une file d'attente, saisissez des minuscules pour Nom, puis sélectionnez Créer.
Créez une autre file d'attente en répétant l'étape précédente en utilisant des majuscules pour Nom.
3.3. Créer une instance Azure Spring Apps
Utilisez la procédure suivante pour créer une instance de service :
Sélectionnez Créer une ressource dans le coin du portail Azure.
Sélectionnez Calcul>Azure Spring Apps.
Remplissez le formulaire Informations de base avec les informations suivantes :
Paramètre
Valeur suggérée
Description
Abonnement
Nom de votre abonnement.
Abonnement Azure que vous souhaitez utiliser pour votre serveur. Si vous disposez de plusieurs abonnements, choisissez celui dans lequel vous souhaitez que la ressource soit facturée.
Groupe de ressources
myresourcegroup
Un nouveau nom de groupe de ressources ou un nom de groupe existant dans votre abonnement.
Nom
myasa
Nom unique qui identifie votre instance Azure Spring Apps. Le nom doit comporter entre 4 et 32 caractères, et 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.
Région
La région la plus proche de vos utilisateurs.
L’emplacement géographique le plus proche de vos utilisateurs.
Options et plans d’hébergement
Entreprise
Plan tarifaire qui détermine la ressource et le coût associés à votre instance.
Redondant interzone
Désactivé
Option permettant de créer votre service Azure Spring Apps dans une zone de disponibilité Azure. Cette fonctionnalité n’est actuellement pas prise en charge dans toutes les régions.
Forfait IP logiciel
Paiement à l’utilisation
Plan tarifaire qui vous permet de payer au fur et à mesure à l’aide d’Azure Spring Apps.
Sélectionnez Vérifier et créer pour passer en revue vos sélections. Ensuite, sélectionnez Créer pour approvisionner l’instance Azure Spring Apps.
Dans la barre d’outils, sélectionnez l’icône Notifications (en forme de cloche) pour surveiller le processus de déploiement. Une fois le déploiement terminé, vous pouvez sélectionner Épingler au tableau de bord, ce qui crée une vignette pour ce service dans votre tableau de bord du Portail Microsoft Azure, en tant que raccourci vers la page Vue d’ensemble du service.
Sélectionnez Accéder à la ressource pour accéder à la page Vue d’ensemble d’Azure Spring Apps.
3.4. Connecter l’instance d’application à l’instance Service Bus
Suivez la procédure ci-dessous pour connecter vos instances de service :
Accédez à votre instance Azure Spring Apps dans le portail Azure.
Dans le volet de navigation, ouvrez le volet Applications et sélectionnez Créer une application.
Sur la page Créer une application, pour le nom de l'application, utilisez simple-event-driven-app et laissez tous les autres champs avec leurs valeurs par défaut.
Sélectionnez Créer pour terminer la création de l’application, puis sélectionnez l’application pour afficher les détails.
Sélectionnez Connecteur de service dans le volet de navigation, puis sélectionnez Créer pour créer une nouvelle connexion de service.
Renseignez l’onglet Informations de base avec les informations suivantes :
Type de service : Sélectionnez Service Bus.
Nom de connexion : renseigné avec un nom généré automatiquement que vous pouvez modifier.
Abonnement : sélectionnez votre abonnement.
Namespace : Sélectionnez l'espace de noms que vous avez créé.
Type de client : Sélectionnez SpringBoot.
Configurez l’onglet Suivant : Authentification avec les informations suivantes :
Sélectionnez le type d’authentification que vous souhaitez utiliser entre votre service de calcul et le service cible. : sélectionnez Chaîne de connexion.
Sélectionnez Suivant : Réseau. Utilisez l’option par défaut Configurer des règles de pare-feu pour activer l’accès au service cible.
Sélectionnez Vérifier + créer pour passer en revue vos sélections, puis sélectionnez Créer pour créer la connexion.
3.1. Donner des noms à chaque ressource
Créez des variables destinées à contenir les noms de ressources à l’aide des commandes suivantes. Veillez à remplacer les espaces réservés par vos valeurs.
Procédez comme suit pour créer un groupe de ressources :
Utilisez la commande suivante pour vous connecter à Azure CLI :
az login
Utilisez la commande suivante pour définir la localisation par défaut :
az configure --defaults location=${LOCATION}
Utilisez la commande suivante pour répertorier tous les abonnements disponibles, puis déterminez l’ID d’abonnement à utiliser :
az account list --output table
Utilisez la commande suivante pour définir votre abonnement par défaut :
az account set --subscription <subscription-ID>
Utilisez la commande suivante pour créer un groupe de ressources :
az group create --resource-group ${RESOURCE_GROUP}
Utilisez la commande suivante pour définir le groupe de ressources nouvellement créé comme groupe de ressources par défaut :
az configure --defaults group=${RESOURCE_GROUP}
3.3. Installer l’extension et inscrire l’espace de noms
Utilisez les commandes suivantes pour installer l’extension Azure Spring Apps pour Azure CLI et inscrire l’espace de noms Microsoft.SaaS :
az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS
3.4. Créer une instance Azure Spring Apps
Utilisez la commande suivante pour créer votre instance Azure Spring Apps :
az spring create \
--name ${AZURE_SPRING_APPS_INSTANCE} \
--sku Enterprise
Ensuite, utilisez la commande suivante pour créer une application dans l’instance Azure Spring Apps :
az spring app create \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME}
3.5. Créer une instance Service Bus
Utilisez la procédure suivante pour créer une instance Service Bus :
Utilisez la commande suivante pour créer un espace de noms Service Bus :
az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
Utilisez les commandes suivantes pour créer deux files d’attente nommées lower-case et upper-case :
az servicebus queue create \
--namespace-name ${SERVICE_BUS_NAME_SPACE} \
--name lower-case
az servicebus queue create \
--namespace-name ${SERVICE_BUS_NAME_SPACE} \
--name upper-case
3.6. Connecter l’instance d’application à l’instance Service Bus
Maintenant, Service Bus et l’application dans Azure Spring Apps ont été créés, mais l’application ne peut pas se connecter à Service Bus. Suivez la procédure ci-dessous pour permettre à l’application de se connecter à Service Bus, puis pour déployer l’application :
Obtenez la chaîne de connexion de Service Bus à l’aide de la commande suivante :
Le bouton Déployer sur Azure dans la section précédente lance une expérience du portail Azure qui inclut le déploiement d’applications. Vous n’avez donc rien d’autre à faire.
La liste suivante décrit les interactions de commande :
Connexion OAuth2 : vous devez autoriser la connexion à Azure en fonction du protocole OAuth2.
Sélectionnez un abonnement : sélectionnez le numéro de liste d’abonnements de l’instance Azure Spring Apps créée, qui correspond par défaut au premier abonnement de la liste. Si vous utilisez le nombre par défaut, appuyez directement sur Entrée.
Utiliser Azure Spring Apps dans Azure : appuyez sur y (oui) pour utiliser l’instance Azure Spring Apps existante.
Sélectionnez Azure Spring Apps pour le déploiement : sélectionnez le numéro de liste de l’instance Azure Spring Apps que vous avez créée. Si vous utilisez le nombre par défaut, appuyez directement sur Entrée.
Utiliser l’application existante dans Azure Spring Apps <your-instance-name> : appuyez sur y (oui) pour utiliser l’application créée.
Confirmez pour enregistrer toutes les configurations ci-dessus : appuyez sur y (oui). Si vous entrez N, la configuration n’est pas enregistrée dans les fichiers POM.
Utilisez la commande suivante pour déployer l’application :
./mvnw azure-spring-apps:deploy
La liste suivante décrit l’interaction de commande :
Connexion OAuth2 : vous devez autoriser la connexion à Azure en fonction du protocole OAuth2.
Une fois la commande exécutée, les messages de journal suivants indiquent que le déploiement a réussi :
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
L’environnement cloud est maintenant prêt. Déployez l’application à l’aide de la commande suivante :
az spring app deploy \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME} \
--artifact-path target/simple-event-driven-app-0.0.2-SNAPSHOT.jar
5. Valider l’application
Utilisez les étapes suivantes pour vérifier que l’application basée sur les événements fonctionne correctement. Vous pouvez valider l’application en envoyant un message à la file d’attente lower-case, puis en confirmant qu’il y a un message dans la file d’attente upper-case.
Accédez à la page Vue d’ensemble de l’instance Azure Spring Apps et sélectionnez Journaux pour vérifier les journaux de l’application.
Utilisez la commande suivante pour vérifier le journal de l’application afin d’examiner tout problème de déploiement :
az spring app logs \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME}
6. Nettoyer les ressources
Assurez-vous de supprimer les ressources que vous avez créées dans cet article lorsque vous n’en aurez plus besoin. Vous pouvez supprimer le groupe de ressources Azure qui inclut toutes les ressources du groupe de ressources.
Pour supprimer l’intégralité du groupe de ressources, y compris le serveur que vous venez de créer, utilisez les étapes suivantes :
Localisez votre groupe de ressources dans le portail Azure. Dans le menu de navigation, sélectionnez Groupes de ressources, puis sélectionnez le nom de votre groupe de ressources.
Dans la page Groupe de ressources, sélectionnez Supprimer. Entrez le nom de votre groupe de ressources dans la zone de texte pour confirmer la suppression, puis sélectionnez Supprimer.
Pour supprimer l’intégralité du groupe de ressources, y compris le serveur que vous venez de créer, utilisez les étapes suivantes :
Localisez votre groupe de ressources dans le portail Azure. Dans le menu de navigation, sélectionnez Groupes de ressources, puis sélectionnez le nom de votre groupe de ressources.
Dans la page Groupe de ressources, sélectionnez Supprimer. Entrez le nom de votre groupe de ressources dans la zone de texte pour confirmer la suppression, puis sélectionnez Supprimer.
Pour supprimer l’intégralité du groupe de ressources, y compris le serveur que vous venez de créer, utilisez les commandes suivantes :
Pour supprimer l’intégralité du groupe de ressources, y compris le serveur que vous venez de créer, utilisez les étapes suivantes :
Localisez votre groupe de ressources dans le portail Azure. Dans le menu de navigation, sélectionnez Groupes de ressources, puis sélectionnez le nom de votre groupe de ressources.
Dans la page Groupe de ressources, sélectionnez Supprimer. Entrez le nom de votre groupe de ressources dans la zone de texte pour confirmer la suppression, puis sélectionnez Supprimer.
Pour supprimer l’intégralité du groupe de ressources, y compris le serveur que vous venez de créer, utilisez les étapes suivantes :
Localisez votre groupe de ressources dans le portail Azure. Dans le menu de navigation, sélectionnez Groupes de ressources, puis sélectionnez le nom de votre groupe de ressources.
Dans la page Groupe de ressources, sélectionnez Supprimer. Entrez le nom de votre groupe de ressources dans la zone de texte pour confirmer la suppression, puis sélectionnez Supprimer.
Utilisez la commande suivante pour supprimer toutes les ressources Azure utilisées dans cet exemple d’application :
azd down
La liste suivante décrit les interactions de commande :
Total des ressources à supprimer : <your-resources-total>, voulez-vous vraiment continuer ? : appuyez sur o.
Souhaitez-vous supprimer définitivement ces ressources à la place, ce qui permet de réutiliser leurs noms ? : appuyez sur O. Appuyez sur N si vous souhaitez réutiliser le coffre de clés.
La console génère des messages similaires à l’exemple suivant :
SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
