Démarrage rapide : Déployer votre première application sur Azure Spring Apps
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.
Cet article explique comment déployer une petite application pour qu’elle s’exécute sur Azure Spring Apps.
Le code applicatif utilisé dans ce tutoriel correspond à une application simple. Une fois cet exemple terminé, l’application est accessible en ligne et vous pouvez la gérer via le Portail Azure.
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 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 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.
L’option IntelliJ utilise un puissant environnement de développement Java pour gérer facilement les ressources Azure. Cette option convient aux développeurs Spring qui sont familiarisés avec les services cloud Azure et IntelliJ IDEA.
L’option Visual Studio Code utilise un éditeur de code source léger mais puissant, qui peut facilement gérer les ressources Azure. Cette option convient aux développeurs Spring qui sont familiarisés avec les services cloud Azure et Visual Studio Code.
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 spring-cloud-azure-tools sur GitHub. Aucune étape de préparation locale n’est nécessaire.
Suivez la procédure ci-dessous pour préparer le projet :
La liste suivante décrit les interactions de commande :
Connexion OAuth2 : vous devez autoriser la connexion à Azure en fonction du protocole OAuth2.
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
Cette section décrit comment créer une instance de service Azure Spring Apps et préparer l’environnement cloud Azure.
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 Azure Spring Apps
Utilisez les étapes suivante pour créer une instance de service 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 à l’aide des renseignements suivants.
Utilisez le tableau suivant comme guide afin de remplir le formulaire. Le Plan recommandé est Standard consumption & dedicated (preview).
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.
Name
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.
Planifier
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) Créez 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 accéder à la page Vue d’ensemble d’Azure Spring Apps.
Pour créer les ressources requises, procédez comme suit :
Utilisez la commande suivante pour vous connecter à Azure avec OAuth2. Ignorez cette étape si vous 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 du texte pour filtrer, puis appuyez sur Entrée.
Sélectionnez un emplacement Azure à utiliser : utilisez les flèches pour vous déplacer, tapez du texte 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 opération peut prendre un certain temps. Un indicateur de progression vous indiquera 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 n (non) pour créer une application.
Entrer le nom de l’application : indiquez un nom pour l’application. Si vous utilisez l’ID d’artefact de projet par défaut, appuyez directement sur Entrée.
Exposer l’accès public pour cette application (boot-for-azure) : appuyez sur o.
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
[INFO] InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:NONE
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io
Utilisez la procédure ci-dessous pour empaqueter l’application, approvisionner les ressources Azure requises par l’application web, puis déployer 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 demo
- Endpoint: https://demo.xxx.<your-azure-location>.azurecontainerapps.io
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 spring-guides/gs-spring-boot-for-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 spring-cloud-azure-tools sur GitHub. Aucune étape de préparation locale n’est nécessaire.
Suivez la procédure ci-dessous pour préparer le projet :
La liste suivante décrit les interactions de commande :
Connexion OAuth2 : vous devez autoriser la connexion à Azure en fonction du protocole OAuth2.
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
Cette section décrit comment créer une instance de service Azure Spring Apps et préparer l’environnement cloud Azure.
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 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
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.
Name
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
Plan tarifaire qui 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
Non sélectionné
Indique s’il faut 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.
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 accéder à la page Vue d’ensemble d’Azure Spring Apps.
Pour créer les ressources requises, procédez comme suit :
Utilisez la commande suivante pour vous connecter à Azure avec OAuth2. Ignorez cette étape si vous 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, provisionner l’infrastructure du modèle sur Azure, puis déployer le code de l’application sur les nouvelles ressources provisionné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 du texte pour filtrer, puis appuyez sur Entrée.
Sélectionnez un emplacement Azure à utiliser : utilisez les flèches pour vous déplacer, tapez du texte pour filtrer, puis appuyez sur Entrée.
La console génère des messages similaires à ceux de 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 opération 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 n (non) pour créer une application.
Entrer le nom de l’application : indiquez un nom pour l’application. Si vous utilisez l’ID d’artefact de projet par défaut, appuyez directement sur Entrée.
Exposer l’accès public pour cette application (boot-for-azure) : appuyez sur o.
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
[INFO] InstanceName:demo-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:UNREGISTERED
[INFO] InstanceName:demo-default-x-xxxxxxxxx-xxxxx Status:Terminating Reason:null DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
Utilisez la procédure ci-dessous pour empaqueter l’application, approvisionner les ressources Azure requises par l’application web, puis déployer 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 à ceux de l’exemple suivant :
Deploying services (azd deploy)
(✓) Done: Deploying service demo
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io/
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 package (empaquette une copie déployable de votre application), azd provision (provisionne les ressources Azure) et azd deploy (déploie le code de l’application). Pour plus d’informations, consultez la page spring-guides/gs-spring-boot-for-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 spring-cloud-azure-tools sur GitHub. Aucune étape de préparation locale n’est nécessaire.
Suivez la procédure ci-dessous pour préparer le projet :
Utilisez la commande suivante pour accéder au dossier du projet :
cd gs-spring-boot-for-azure/complete
Utilisez la commande Maven suivante pour générer le projet :
./mvnw clean package
Exécutez l’exemple de projet localement à l’aide de la commande suivante :
./mvnw spring-boot:run
Pour créer le projet, procédez comme suit :
Utilisez la commande ci-dessous pour générer un exemple de projet à partir de start.spring.io avec les dépendances recommandées pour Azure Spring Apps :
Créez un contrôleur web pour votre application web en ajoutant le fichier src/main/java/com/example/demo/HelloController.java avec le contenu suivant :
package com.example.demo;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMapping;
@RestController
public class HelloController {
@RequestMapping("/")
public String index() {
return "Hello World";
}
}
Utilisez la commande Maven suivante pour générer le projet :
./mvnw clean package
Exécutez l’exemple de projet localement à l’aide de la commande suivante :
./mvnw spring-boot:run
Pour préparer le projet Spring, suivez la procédure décrite dans la section Before you begin (Avant de commencer) de l’article Java on Azure Spring Apps (Java sur Azure Spring Apps).
3. Préparer l’environnement cloud
Cette section décrit comment créer une instance de service Azure Spring Apps et préparer l’environnement cloud Azure.
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 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
Non sélectionné
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.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 procédure suivante pour créer une instance de service :
Utilisez la commande suivante pour accepter les conditions d’utilisation et la déclaration de confidentialité du plan Entreprise :
Remarque
Cette étape est nécessaire uniquement si votre abonnement n’a jamais été utilisé pour créer une instance de niveau Entreprise d’Azure Spring Apps.
az term accept \
--publisher vmware-inc \
--product azure-spring-cloud-vmware-tanzu-2 \
--plan asa-ent-hr-mtr
Utilisez la commande suivante pour créer une instance de service Azure Spring Apps :
az spring create \
--name ${SERVICE_NAME} \
--sku Enterprise
3.5. Création d’une application dans l’instance Azure Spring Apps
Une application est l’abstraction d’une application métier. Pour plus d’informations, consultez Application et déploiement dans Azure Spring Apps. Les applications s’exécutent dans une instance de service Azure Spring Apps, comme illustré dans le diagramme suivant.
Utilisez la commande suivante pour créer l’application sur Azure Spring Apps :
az spring app create \
--service ${SERVICE_NAME} \
--name ${APP_NAME} \
--assign-endpoint true
3.1. Connectez-vous au portail Azure.
Ouvrez votre navigateur web et allez sur le portail Azure, entrez vos identifiants et connectez-vous au portail. Il s’ouvre par défaut sur le tableau de bord des services.
3.2. 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
Non sélectionné
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.
Pour créer une instance Azure Spring Apps, suivez la procédure décrite dans la section Create an app on Azure Spring Apps (Créer une application sur Azure Spring Apps) de l’article Java on Azure Spring Apps (Java sur Azure Spring Apps).
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 n (non) pour créer une application.
Entrer le nom de l’application : indiquez un nom pour l’application. Si vous utilisez l’ID d’artefact de projet par défaut, appuyez directement sur Entrée.
Exposer l’accès public pour cette application (boot-for-azure) : appuyez sur o.
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
[INFO] InstanceName:demo-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:N/A
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
Utilisez la commande suivante pour déployer le fichier .jar pour l’application :
az spring app deploy \
--service ${SERVICE_NAME} \
--name ${APP_NAME} \
--artifact-path target/demo-0.0.1-SNAPSHOT.jar
Le déploiement de l’application peut prendre quelques minutes.
Cette section décrit les étapes à suivre pour déployer votre application sur Azure Spring Apps.
4.1. Importer le projet
Suivez la procédure ci-dessous pour importer le projet :
Ouvrez IntelliJ IDEA et sélectionnez Ouvrir.
Dans la boîte de dialogue Ouvrir un fichier ou un projet, sélectionnez le dossier demo.
4.2. Créer et déployer votre application
Suivez la procédure ci-dessous pour générer et déployer votre application :
Azure Toolkit for IntelliJ offre quatre façons de se connecter à Azure, et le déploiement ne peut démarrer qu’une fois la connexion établie.
Cliquez avec le bouton droit sur la fenêtre Projet IntelliJ, puis sélectionnez Azure ->Déployer sur Azure Spring Apps.
Acceptez le nom de l’application dans le champ Name. Name fait référence à la configuration, pas au nom de l’application. Il n’est généralement pas nécessaire de la changer.
Dans la zone de texte Artifact, sélectionnez Maven:demo(Java 17).
Dans la zone de texte Abonnement, vérifiez que votre abonnement est correct.
Dans la zone de texte Spring Apps, sélectionnez l’instance Azure Spring Apps que vous avez créée.
Dans la zone de texte Application, sélectionnez le symbole plus (+) pour créer une application.
Dans la zone de texte Nom de l’application qui se trouve sous Paramètres de base de l’application, entrez demo, puis sélectionnez Plus de paramètres.
Sélectionnez le bouton Enable à côté de Public endpoint. Le bouton prend la valeur Désactivé <à activer>. Ensuite, sélectionnez OK.
Sous Avant le lancement, sélectionnez Exécuter l’objectif Maven « demo:package », puis sélectionnez l’icône en forme de crayon pour modifier la ligne de commande.
Dans la zone de texte Ligne de commande, entrez -DskipTests après package, puis sélectionnez OK.
Pour commencer le déploiement, sélectionnez le bouton Exécuter situé en bas de la boîte de dialogue Déployer dans Azure. Le plug-in exécute la commande Maven package -DskipTests sur l’application demo, puis déploie le fichier .jar généré par la commande package.
Le déploiement de l’application peut prendre quelques minutes. Vous pouvez voir l’URL publique de l’application dans le journal de la console de sortie.
Pour déployer l’application sur Azure Spring Apps, suivez la procédure décrite dans la section Build and deploy the app (Générer et déployer l’application) de l’article Java on Azure Spring Apps (Java sur Azure Spring Apps).
5. Valider l’application
Cette section explique comment valider votre application.
Une fois le déploiement terminé, recherchez l’URL de l’application à partir des sorties de déploiement. Utilisez les étapes suivantes pour valider :
Accédez à l’URL de l’application à partir de la page Sorties du Déploiement. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
Consultez les détails de chaque déploiement de ressources, qui sont utiles pour examiner les problèmes de déploiement.
Une fois le déploiement terminé, accédez à l’application avec l’URL de l’application de sortie. Procédez comme suit pour vérifier les journaux d’activité de l’application afin d’identifier un éventuel problème de déploiement :
Accédez à l’URL de l’application de sortie à partir de la page Sorties du Déploiement. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
Dans le volet de navigation de la page Vue d’ensemble de l’instance Azure Spring Apps, sélectionnez Journaux d’activité pour vérifier les journaux d’activité de l’application.
Une fois le déploiement terminé, accédez à l’application avec le point de terminaison de sortie. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
Une fois le déploiement terminé, procédez comme suit pour trouver l’URL de l’application à partir des sorties du déploiement :
Accédez à l’URL de l’application à partir de la page Sorties du Déploiement. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
Consultez les détails de chaque déploiement de ressources, qui sont utiles pour examiner les problèmes de déploiement.
Une fois le déploiement terminé, procédez comme suit pour vérifier les journaux d’activité de l’application afin d’identifier un éventuel problème de déploiement :
Accédez à l’URL de l’application à partir de la page Sorties du Déploiement. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
Dans le volet de navigation de la page de vue d’ensemble de l’instance Azure Spring Apps, sélectionnez Journaux pour vérifier les journaux de l’application.
Une fois le déploiement terminé, accédez à l’application avec le point de terminaison de sortie. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
Une fois le déploiement terminé, procédez comme suit pour trouver l’URL de l’application à partir des sorties du déploiement :
Accédez à l’URL de l’application à partir de la page Sorties du Déploiement. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
Consultez les détails de chaque déploiement de ressources, qui sont utiles pour examiner les problèmes de déploiement.
Une fois le déploiement terminé, procédez comme suit pour valider l’application :
Accédez à l’URL de l’application. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
Vérifiez les journaux de la console, qui sont utiles pour examiner les éventuels problèmes de déploiement.
Une fois le déploiement terminé, procédez comme suit pour vérifier les journaux d’activité de l’application afin d’identifier un éventuel problème de déploiement :
Accédez à l’application avec l’URL de l’application de sortie. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
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 ${SERVICE_NAME} \
--name ${APP_NAME}
Suivez la procédure ci-dessous pour diffuser en continu les journaux d’application :
Accédez à l’application avec l’URL de l’application de sortie. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
Ouvrez la fenêtre Azure Explorer, développez le nœud Azure, développez le nœud de service Azure Spring Apps, développez l’instance Azure Spring Apps que vous avez créée, puis sélectionnez l’instance demo de l’application que vous avez créée.
Cliquez avec le bouton droit et sélectionnez Commencer le streaming des journaux, puis sélectionnez OK pour afficher les journaux d’application en temps réel.
Suivez la procédure ci-dessous pour diffuser en continu les journaux d’application :
Accédez à l’application avec l’URL de l’application de sortie. Quand vous ouvrez l’application, vous obtenez la réponse Hello World.
Si vous prévoyez d’utiliser d’autres guides de démarrage rapide et tutoriels, vous pouvez conserver ces ressources. Lorsque vous n’avez plus besoin des ressources, vous pouvez supprimer les ressources inutiles pour éviter des frais Azure.
Procédez comme suit pour supprimer l’ensemble du groupe de ressources, y compris l’instance de service nouvellement créée :
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.
Procédez comme suit pour supprimer l’ensemble du groupe de ressources, y compris la nouvelle instance de service créée :
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 le groupe de ressources à l’aide d’Azure CLI :
az group delete --name ${RESOURCE_GROUP}
Procédez comme suit pour supprimer le groupe de ressources à l’aide d’IntelliJ :
Accédez à votre Intellij IDEA et recherchez le nom de votre groupe de ressources.
Faites un clic droit sur le groupe de ressources et sélectionnez Supprimer pour supprimer toutes les ressources Azure associées.
Procédez comme suit pour supprimer le groupe de ressources à l’aide de Visual Studio Code :
Accédez à Visual Studio Code, sélectionnez Regrouper par pour activer Groupe par groupe de ressources, puis recherchez le nom de votre groupe de ressources.
Faites un clic droit sur le groupe de ressources et sélectionnez Supprimer le groupe de ressources... pour supprimer toutes les ressources Azure associées.
Procédez comme suit pour supprimer l’ensemble du groupe de ressources, y compris l’instance de service nouvellement créée :
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.
Procédez comme suit pour supprimer l’ensemble du groupe de ressources, y compris la nouvelle instance de service créée :
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 l’interaction de commande :
Total des ressources à supprimer : <your-resources-total>, voulez-vous vraiment continuer ? : appuyez sur o.
La console génère des messages similaires à l’exemple suivant :
SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
