Démarrage rapide : Déployer votre première application web sur Azure Spring Apps

Remarque

Les plans Essentiel, Standard et Entreprise seront déconseillés à compter de la mi-mars 2025, avec une période de mise hors service de 3 ans. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez l’annonce de mise hors service d’Azure Spring Apps.

Le plan de consommation standard et dédiée sera déconseillé à compter du 30 septembre 2024, avec un arrêt complet après six mois. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez Migrer le plan de consommation standard et dédiée Azure Spring Apps vers Azure Container Apps.

Ce guide de démarrage rapide montre comment déployer une application web Spring Boot sur Azure Spring Apps. L’exemple de projet est une application ToDo simple pour ajouter des tâches, indiquer lorsqu’elles sont terminées, puis les supprimer. La capture d’écran suivante montre l’application :

Cette application web classique contient les trois couches suivantes :

• Application React limitée en front-end.
• Application web Spring en back-end qui utilise Spring Data JPA pour accéder à une base de données relationnelle.
• Base de données relationnelle. Pour localhost, l’application utilise le moteur de base de données H2. Pour Azure Spring Apps, l’application utilise Azure Database pour PostgreSQL. Pour plus d’informations sur Azure Database pour PostgreSQL, consultez la documentation sur le Serveur flexible.

Le diagramme suivant présente l’architecture du système :

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 + plug-in Maven fournit un moyen plus conventionnel de créer des ressources et de déployer des applications pas à pas. 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.

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 + plug-in Maven fournit un moyen plus conventionnel de créer des ressources et de déployer des applications pas à pas. 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.

1. Prérequis

Azure portal

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.

Portail Azure + plug-in Maven

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.
• Git.
• Kit de développement Java (JDK), version 17.

Azure Developer CLI

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.
• Git.
• Kit de développement Java (JDK), version 17.
• Azure Developer CLI (AZD) version 1.2.0 ou ultérieure.

Azure portal

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.

Portail Azure + plug-in Maven

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.
• Git.
• Kit de développement Java (JDK), version 17.

Azure CLI

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.
• Git.
• Kit de développement Java (JDK), version 17.
• Azure CLI version 2.45.0 ou ultérieure. Utilisez la commande suivante pour installer l’extension Azure Spring Apps : az extension add --name spring
• Si vous déployez une instance du plan Entreprise Azure Spring Apps pour la première fois dans l’abonnement cible, consultez la section Exigences du Plan Entreprise dans la Place de marché Azure.

2. Préparer le projet Spring

Azure portal

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.

Portail Azure + plug-in Maven

Bien que vous utilisiez le portail Azure dans les étapes ultérieures, vous devez utiliser la ligne de commande Bash pour préparer le projet localement. Procédez comme suit pour cloner et exécuter l’application localement :

1. Utilisez la commande suivante pour cloner l’exemple de projet à partir de GitHub :

   git clone https://github.com/Azure-Samples/ASA-Samples-Web-Application.git
   

2. Utilisez la commande suivante pour générer l’exemple de projet avec Maven :

   cd ASA-Samples-Web-Application
   ./mvnw clean package
   

3. Utilisez la commande suivante pour exécuter l’exemple d’application :

   java -jar web/target/simple-todo-web.jar
   

4. Accédez à http://localhost:8080 dans votre navigateur pour accéder à l’application.

Azure CLI

Procédez comme suit pour cloner et exécuter l’application localement :

1. Utilisez la commande suivante pour cloner l’exemple de projet à partir de GitHub :

   git clone https://github.com/Azure-Samples/ASA-Samples-Web-Application.git
   

2. Utilisez la commande suivante pour générer l’exemple de projet avec Maven :

   cd ASA-Samples-Web-Application
   ./mvnw clean package
   

3. Utilisez la commande suivante pour exécuter l’exemple d’application :

   java -jar web/target/simple-todo-web.jar
   

4. Accédez à http://localhost:8080 dans votre navigateur pour accéder à l’application.

3. Préparer l’environnement cloud

Pour exécuter cet exemple, les principales ressources requises sont une instance Azure Spring Apps et une instance Azure Database pour PostgreSQL. Cette section décrit les étapes de création de ces ressources.

Azure portal

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 :

1. Sélectionnez le bouton Déployer sur Azure suivant pour lancer l’expérience de déploiement dans le Portail Microsoft Azure :

   

2. 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.
   Mot de passe de l’administrateur PostgreSQL	N/A	Mot de passe de l’administrateur du serveur PostgreSQL.
   Mot de passe de l’utilisateur PostgreSQL	N/A	Mot de passe de l’utilisateur de l’application PostgreSQL, qui est utilisé dans l’application.

   

3. 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.

4. 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.

   

Portail Azure + plug-in Maven

3.1. Connectez-vous au portail Azure.

Accédez auportail Azure, entrez vos informations d’identification 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 :

1. Sélectionnez Créer une ressource dans le coin du portail Azure.

2. Sélectionnez Calcul>Azure Spring Apps.

   

3. 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.
   Planifier	Entreprise	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é	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.
   Plan IP logiciel	Paiement à l’utilisation	Plan de paiement à l’utilisation pour Azure Spring Apps.
   Terms	Volumes sélectionnés	Case à cocher du contrat associée à l’offre de la Place de marché. Vous devez cocher cette case.
   Déployer l’exemple de projet	Non sélectionné	Option permettant d’utiliser l’exemple d’application intégré.

   

4. 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.

5. 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.

   

6. Sélectionnez Accéder à la ressource pour accéder à la page Vue d’ensemble d’Azure Spring Apps.

3.3. Préparer l’instance PostgreSQL

Suivez la procédure ci-dessous pour créer un serveur Azure Database pour PostgreSQL :

1. Dans le portail Azure, sélectionnez Créer une ressource.

2. Sélectionnez Base de données>Serveur flexible Azure Database pour PostgreSQL.

   

3. Renseignez l’onglet Informations de base avec les informations suivantes :

   • Nom du serveur : my-demo-pgsql
   • Région : USA Est
   • Version PostgreSQL : 14
   • Type de charge de travail : Développement
   • Activer la haute disponibilité : désélectionné
   • Méthode d’authentification : Authentification PostgreSQL uniquement
   • Nom d’utilisateur administrateur : myadmin
   • Mot de passe et Confirmer le mot de passe : entrez un mot de passe.

4. Configurez l’onglet Mise en réseau avec les informations suivantes :

   • Méthode de connectivité : Accès public (adresses IP autorisées)
   • Autoriser l’accès public à partir d’un service Azure dans Azure sur ce serveur : sélectionné

   

5. Sélectionnez Vérifier + créer pour passer en revue vos sélections, puis sélectionnez Créer pour approvisionner le serveur. Cette opération peut prendre quelques minutes.

6. Accédez à votre serveur PostgreSQL dans le portail Azure.

7. Sélectionnez Bases de données dans le menu de navigation pour créer une base de données, par exemple; Todo.

   

3.4. Connecter une instance d’application à une instance PostgreSQL

Suivez la procédure ci-dessous pour connecter vos instances de service :

1. Accédez à votre instance Azure Spring Apps dans le portail Azure.

2. Dans le volet de navigation, ouvrez Applications, puis sélectionnez Créer une application.

3. Dans la page Créer une application, pour le nom de l’application, utilisez simple-todo-web et laissez tous les autres champs avec leurs valeurs par défaut.

4. Sélectionnez Créer pour terminer la création de l’application, puis sélectionnez l’application pour afficher les détails.

5. Sélectionnez Connecteur de service dans le volet de navigation, puis sélectionnez Créer pour créer une nouvelle connexion de service.

   

6. Renseignez l’onglet Informations de base avec les informations suivantes :

   • Type de service : Serveur flexible DB pour PostgreSQL
   • Nom de connexion : renseigné avec un nom généré automatiquement que vous pouvez modifier.
   • Abonnement : sélectionnez votre abonnement.
   • Serveur flexible PostgreSQL : my-demo-pgsql
   • Base de données PostgreSQL : sélectionnez la base de données que vous avez créée.
   • Type de client : SpringBoot

   

7. 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.
   • Continuer avec... : sélectionnez Informations d’identification de la base de données
   • Nom d’utilisateur : myadmin
   • Mot de passe : entrez votre mot de passe.

   

8. 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..

9. Sélectionnez Suivant : Vérifier et créer pour passer en revue vos sélections, puis sélectionnez Créer pour créer la connexion.

Azure CLI

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.

export RESOURCE_GROUP=<resource-group-name>
export LOCATION=<location>
export POSTGRESQL_SERVER=<server-name>
export POSTGRESQL_DB=<database-name>
export POSTGRESQL_ADMIN_USERNAME=<admin-username>
export POSTGRESQL_ADMIN_PASSWORD=<admin-password>
export AZURE_SPRING_APPS_NAME=<Azure-Spring-Apps-service-instance-name>
export APP_NAME=<web-app-name>

3.2. Création d’un groupe de ressources

Procédez comme suit pour créer un groupe de ressources.

1. Utilisez la commande suivante pour vous connecter à Azure CLI :

   az login
   

2. Utilisez la commande suivante pour définir la localisation par défaut.

   az configure --defaults location=${LOCATION}
   

3. Utilisez la commande suivante pour répertorier tous les abonnements disponibles, puis déterminez l’ID d’abonnement à utiliser.

   az account list --output table
   

4. Utilisez la commande suivante pour définir votre abonnement par défaut :

   az account set --subscription <subscription-ID>
   

5. Utilisez la commande suivante pour créer un groupe de ressources.

   az group create --resource-group ${RESOURCE_GROUP}
   

6. 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. Créer une instance Azure Spring Apps

Azure Spring Apps est utilisé pour héberger l’application web Spring. Créez une instance Azure Spring Apps et une application à l’intérieur de celle-ci.

1. Utilisez la commande suivante pour créer une instance de service Azure Spring Apps.

   az spring create --name ${AZURE_SPRING_APPS_NAME} --sku enterprise
   

2. Utilisez la commande suivante pour créer une application dans l’instance Azure Spring Apps.

   az spring app create \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME} \
       --assign-endpoint true
   

3.4. Préparer l’instance PostgreSQL

L’application web Spring utilise H2 pour la base de données dans localhost et Azure Database pour PostgreSQL pour la base de données dans Azure.

Utilisez la commande suivante pour créer une instance PostgreSQL :

az postgres flexible-server create \
    --name ${POSTGRESQL_SERVER} \
    --database-name ${POSTGRESQL_DB} \
    --admin-user ${POSTGRESQL_ADMIN_USERNAME} \
    --admin-password ${POSTGRESQL_ADMIN_PASSWORD} \
    --public-access 0.0.0.0

La spécification de 0.0.0.0 permet l’accès public à votre serveur à partir de toutes les ressources déployées dans Azure.

3.5. Connecter une instance d’application à une instance PostgreSQL

Après avoir créé l’instance d’application et l’instance PostgreSQL, l’instance d’application ne peut pas accéder directement à l’instance PostgreSQL. Effectuez les étapes suivantes pour permettre à l’application de se connecter à l’instance PostgreSQL.

1. Utilisez la commande suivante pour obtenir le nom de domaine complet de l’instance PostgreSQL :

   export PSQL_FQDN=$(az postgres flexible-server show \
       --name ${POSTGRESQL_SERVER} \
       --query fullyQualifiedDomainName \
       --output tsv)
   

2. Utilisez la commande suivante pour fournir les propriétés spring.datasource. à l’application via des variables d’environnement :

   az spring app update \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME} \
       --env SPRING_DATASOURCE_URL="jdbc:postgresql://${PSQL_FQDN}:5432/${POSTGRESQL_DB}?sslmode=require" \
             SPRING_DATASOURCE_USERNAME="${POSTGRESQL_ADMIN_USERNAME}" \
             SPRING_DATASOURCE_PASSWORD="${POSTGRESQL_ADMIN_PASSWORD}"
   

4. Déployer l’application sur Azure Spring Apps

Azure portal

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.

Portail Azure + plug-in Maven

Utilisez la procédure suivante pour le déploiement en utilisant le plug-in Maven pour Azure Spring Apps :

1. Accédez au répertoire complete, puis exécutez la commande suivante pour configurer l’application dans Azure Spring Apps :

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   La liste suivante décrit les interactions de commande :

   • Sélectionner des modules enfants à configurer : sélectionnez le module à configurer, puis entrez le numéro du module Web SimpleTodo.
   • 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électionner Azure Spring Apps pour le déploiement : sélectionnez le numéro de l’instance Azure Spring Apps que vous avez créée. Si vous utilisez le nombre par défaut, appuyez directement sur Entrée.
   • Exposer l’accès public pour cette application : appuyez sur y (oui).
   • 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.

2. 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 Status: Running
[INFO]   InstanceName:simple-todo-web-default-15-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:N/A       
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io

L’URL d’application de sortie est le point de terminaison permettant d’accéder à l’application todo.

Azure CLI

Maintenant que l’environnement cloud est prêt, l’application est prête à être déployée. Utilisez la commande suivante pour déployer l’application :

az spring app deploy \
    --service ${AZURE_SPRING_APPS_NAME} \
    --name ${APP_NAME} \
    --artifact-path web/target/simple-todo-web.jar

2. Préparer le projet Spring

Azure portal

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.

Portail Azure + plug-in Maven

Bien que vous utilisiez le portail Azure dans les étapes ultérieures, vous devez utiliser la ligne de commande Bash pour préparer le projet localement. Procédez comme suit pour cloner et exécuter l’application localement :

1. Utilisez la commande suivante pour cloner l’exemple de projet à partir de GitHub :

   git clone https://github.com/Azure-Samples/ASA-Samples-Web-Application.git
   

2. Utilisez la commande suivante pour générer l’exemple de projet avec Maven :

   cd ASA-Samples-Web-Application
   ./mvnw clean package
   

3. Utilisez la commande suivante pour exécuter l’exemple d’application :

   java -jar web/target/simple-todo-web.jar
   

4. Accédez à http://localhost:8080 dans votre navigateur pour accéder à l’application.

Azure Developer CLI

Procédez comme suit pour initialiser l’application web à partir des modèles Azure Developer CLI :

1. Ouvrez un terminal, créez un dossier vide, puis changez de répertoire dans ce dossier.

2. Utilisez la commande ci-dessous pour initialiser le projet :

   azd init --template https://github.com/Azure-Samples/ASA-Samples-Web-Application
   

   La liste suivante décrit l’interaction 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

Pour exécuter cet exemple, les principales ressources requises sont une instance Azure Spring Apps et une instance Azure Database pour PostgreSQL. Cette section décrit les étapes de création de ces ressources.

Azure portal

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 :

1. Sélectionnez le bouton Déployer sur Azure suivant pour lancer l’expérience de déploiement dans le Portail Microsoft Azure :

   

2. 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.
   Mot de passe de l’administrateur PostgreSQL	S/O	Mot de passe de l’administrateur du serveur PostgreSQL.
   Mot de passe de l’utilisateur PostgreSQL	S/O	Mot de passe de l’utilisateur de l’application PostgreSQL, qui est utilisé dans l’application.

   

3. 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.

4. 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.

   

Portail Azure + plug-in Maven

Pour créer une instance Azure Spring Apps et une instance Azure Database pour PostgreSQL, procédez comme suit :

3.1. Connectez-vous au portail Azure.

Accédez auportail Azure, entrez vos informations d’identification 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 :

1. Sélectionnez Créer une ressource dans le coin du portail.

2. Sélectionnez Calcul>Azure Spring Apps.

   

3. 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	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.

   

4. (Facultatif) Renseignez l’onglet Informations de base avec les informations suivantes pour créer un environnement Container Apps :

   • Nom de l’environnement : myacaenv
   • Plan : Consommation
   • Redondance de zone : Désactivée

   

   Ensuite, sélectionnez Créer pour créer l’environnement Container Apps.

5. 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.

6. 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.3. Préparer l’instance PostgreSQL

Suivez la procédure ci-dessous pour créer un serveur Azure Database pour PostgreSQL :

1. Dans le portail Azure, sélectionnez Créer une ressource.

2. Sélectionnez Base de données>Serveur flexible Azure Database pour PostgreSQL.

   

3. Renseignez l’onglet Informations de base avec les informations suivantes :

   • Nom du serveur : my-demo-pgsql
   • Région : USA Est
   • Version PostgreSQL : 14
   • Type de charge de travail : Développement
   • Activer la haute disponibilité : désélectionné
   • Méthode d’authentification : Authentification PostgreSQL uniquement
   • Nom d’utilisateur administrateur : myadmin
   • Mot de passe et Confirmer le mot de passe : entrez un mot de passe.

4. Configurez l’onglet Mise en réseau avec les informations suivantes :

   • Méthode de connectivité : Accès public (adresses IP autorisées)
   • Autoriser l’accès public à partir d’un service Azure dans Azure sur ce serveur : sélectionné

   

5. Sélectionnez Vérifier + créer pour passer en revue vos sélections, puis sélectionnez Créer pour approvisionner le serveur. Cette opération peut prendre quelques minutes.

6. Accédez à votre serveur PostgreSQL dans le portail Azure.

7. Sélectionnez Bases de données dans le menu de navigation pour créer une base de données, par exemple; Todo.

   

3.4. Connecter une instance d’application à une instance PostgreSQL

Suivez la procédure ci-dessous pour connecter vos instances de service :

1. Accédez à votre instance Azure Spring Apps dans le portail Azure.

2. Dans le volet de navigation, ouvrez Applications, puis sélectionnez Créer une application.

3. Dans la page Créer une application, pour le nom de l’application, utilisez simple-todo-web, puis sélectionnez Utiliser l’exemple d’application de démarrage rapide pour créer l’application.

   

4. Sélectionnez Créer pour terminer la création de l’application, puis sélectionnez l’application pour en afficher les détails.

5. Sélectionnez Configuration dans le volet de navigation, puis configurez les propriétés suivantes sous l’onglet Variables d’environnement :

   • SPRING_DATASOURCE_URL : jdbc:postgresql://my-demo-pgsql.postgres.database.azure.com:5432/todo?sslmode=require
   • SPRING_DATASOURCE_USERNAME : myadmin
   • SPRING_DATASOURCE_PASSWORD : entrez votre mot de passe.

   

6. Sélectionnez Enregistrer pour enregistrer les propriétés de la connexion.

Azure Developer CLI

Pour créer une instance Azure Spring Apps et une instance Azure Database pour PostgreSQL, procédez comme suit :

1. 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.
   

2. 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> 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.

4. Déployer l’application sur Azure Spring Apps

Azure portal

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.

Portail Azure + plug-in Maven

Utilisez la procédure suivante pour le déploiement en utilisant le plug-in Maven pour Azure Spring Apps :

1. Accédez au répertoire complete, puis exécutez la commande suivante pour configurer l’application dans Azure Spring Apps :

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   La liste suivante décrit les interactions de commande :

   • Sélectionner des modules enfants à configurer : sélectionnez le module à configurer, puis entrez le numéro du module Web SimpleTodo.
   • 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électionner Azure Spring Apps pour le déploiement : sélectionnez le numéro de l’instance Azure Spring Apps que vous avez créée. Si vous utilisez le nombre par défaut, appuyez directement sur Entrée.
   • Exposer l’accès public pour cette application : appuyez sur y (oui).
   • 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.

2. 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] Start updating app(simple-todo-web)...
[INFO] App(simple-todo-web) is successfully updated.
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO]   InstanceName:simple-todo-web--default-xxxxxxx-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:NONE
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://simple-todo-web.<unique-identifier>.<region-name>.azurecontainerapps.io

L’URL d’application de sortie est le point de terminaison permettant d’accéder à l’application todo.

Azure Developer CLI

Vous pouvez maintenant déployer l’application sur Azure Spring Apps. 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 :

1. 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.
   

2. 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-todo-web
   - Endpoint: https://simple-todo-web.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
   

   Le Point de terminaison de sortie est le point de terminaison permettant d’accéder à l’application todo.

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 Azure-Samples/ASA-Samples-Web-Application.

2. Préparer le projet Spring

Azure portal

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.

Portail Azure + plug-in Maven

Bien que vous utilisiez le portail Azure dans les étapes ultérieures, vous devez utiliser la ligne de commande Bash pour préparer le projet localement. Procédez comme suit pour cloner et exécuter l’application localement :

1. Utilisez la commande suivante pour cloner l’exemple de projet à partir de GitHub :

   git clone https://github.com/Azure-Samples/ASA-Samples-Web-Application.git
   

2. Utilisez la commande suivante pour générer l’exemple de projet avec Maven :

   cd ASA-Samples-Web-Application
   ./mvnw clean package
   

3. Utilisez la commande suivante pour exécuter l’exemple d’application :

   java -jar web/target/simple-todo-web.jar
   

4. Accédez à http://localhost:8080 dans votre navigateur pour accéder à l’application.

Azure Developer CLI

Procédez comme suit pour initialiser l’application web à partir des modèles Azure Developer CLI :

1. Ouvrez un terminal, créez un dossier vide, puis changez de répertoire dans ce dossier.

2. Utilisez la commande ci-dessous pour initialiser le projet :

   azd init --template https://github.com/Azure-Samples/ASA-Samples-Web-Application
   

   La liste suivante décrit l’interaction 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>
   
   Please 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

Pour exécuter cet exemple, les principales ressources requises sont une instance Azure Spring Apps et une instance Azure Database pour PostgreSQL. Cette section décrit les étapes de création de ces ressources.

Azure portal

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 :

1. Sélectionnez le bouton Déployer sur Azure suivant pour lancer l’expérience de déploiement dans le Portail Microsoft Azure :

   

2. 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.
   Mot de passe de l’administrateur PostgreSQL	N/A	Mot de passe de l’administrateur du serveur PostgreSQL.
   Mot de passe de l’utilisateur PostgreSQL	N/A	Mot de passe de l’utilisateur de l’application PostgreSQL, qui est utilisé dans l’application.

   

3. 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.

4. 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.

   

Portail Azure + plug-in Maven

Pour créer une instance Azure Spring Apps et une instance Azure Database pour PostgreSQL, procédez comme suit :

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 :

1. Sélectionnez Créer une ressource dans le coin du portail.

2. Sélectionnez Calcul>Azure Spring Apps.

   

3. 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	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	De base	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.
   Redondant interzone	Non sélectionné	Indique s’il faut créer votre service Azure Spring Apps dans une zone de disponibilité Azure. Actuellement, cette fonctionnalité est prise en charge uniquement dans certaines régions.

   

4. 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.

5. 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.3. Préparer l’instance PostgreSQL

Suivez la procédure ci-dessous pour créer un serveur Azure Database pour PostgreSQL :

1. Dans le portail Azure, sélectionnez Créer une ressource.

2. Sélectionnez Base de données>Serveur flexible Azure Database pour PostgreSQL.

   

3. Renseignez l’onglet Informations de base avec les informations suivantes :

   • Nom du serveur : my-demo-pgsql
   • Région : USA Est
   • Version PostgreSQL : 14
   • Type de charge de travail : Développement
   • Activer la haute disponibilité : désélectionné
   • Méthode d’authentification : Authentification PostgreSQL uniquement
   • Nom d’utilisateur administrateur : myadmin
   • Mot de passe et Confirmer le mot de passe : entrez un mot de passe.

4. Configurez l’onglet Mise en réseau avec les informations suivantes :

   • Méthode de connectivité : Accès public (adresses IP autorisées)
   • Autoriser l’accès public à partir d’un service Azure dans Azure sur ce serveur : sélectionné

   

5. Sélectionnez Vérifier + créer pour passer en revue vos sélections, puis sélectionnez Créer pour approvisionner le serveur. Cette opération peut prendre quelques minutes.

6. Accédez à votre serveur PostgreSQL dans le portail Azure.

7. Sélectionnez Bases de données dans le menu de navigation pour créer une base de données, par exemple; Todo.

   

3.4. Connecter une instance d’application à une instance PostgreSQL

Suivez la procédure ci-dessous pour connecter vos instances de service :

1. Accédez à votre instance Azure Spring Apps dans le portail Azure.

2. Dans le volet de navigation, ouvrez le volet Applications et sélectionnez Créer une application.

3. Dans la page Créer une application, pour le nom de l’application, utilisez simple-todo-web et pour la plateforme de runtime, sélectionnez Java 17.

   

4. Sélectionnez Créer pour terminer la création de l’application, puis sélectionnez l’application pour afficher les détails.

5. Sélectionnez Connecteur de service dans le volet de navigation, puis sélectionnez Créer pour créer une nouvelle connexion de service.

   

6. Renseignez l’onglet Informations de base avec les informations suivantes :

   • Type de service : Serveur flexible DB pour PostgreSQL
   • Nom de connexion : renseigné avec un nom généré automatiquement que vous pouvez modifier.
   • Abonnement : sélectionnez votre abonnement.
   • Serveur flexible PostgreSQL : my-demo-pgsql
   • Base de données PostgreSQL : sélectionnez la base de données que vous avez créée.
   • Type de client : SpringBoot

   

7. 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.
   • Continuer avec... : sélectionnez Informations d’identification de la base de données.
   • Nom d’utilisateur : myadmin
   • Mot de passe : entrez votre mot de passe.

   

8. 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..

9. Sélectionnez Suivant : Vérifier et créer pour passer en revue vos sélections, puis sélectionnez Créer pour créer la connexion.

Azure Developer CLI

Pour créer une instance Azure Spring Apps et une instance Azure Database pour PostgreSQL, procédez comme suit :

1. 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.
   

2. Utilisez la commande suivante pour définir le modèle avec le plan standard :

   azd env set PLAN standard
   

3. 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> 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.

4. Déployer l’application sur Azure Spring Apps

Azure portal

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.

Portail Azure + plug-in Maven

Vous pouvez maintenant déployer l’application sur Azure Spring Apps.

Utilisez la procédure suivante pour le déploiement avec le plug-in Maven pour Azure Spring Apps :

1. Accédez au répertoire de l’exemple de projet et utilisez la commande suivante pour configurer l’application dans Azure Spring Apps :

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   La liste suivante décrit les interactions de commande :

   • Sélectionner des modules enfants à configurer : sélectionnez le module à configurer, puis entrez le numéro du module Web SimpleTodo.
   • Connexion OAuth2 : autorisez 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 numéro par défaut, appuyez directement sur Entrée.
   • Sélectionnez Azure Spring Apps : sélectionnez le numéro de l’instance Azure Spring Apps que vous avez créée. Si vous utilisez le numéro par défaut, appuyez directement sur Entrée.
   • Exposer l’accès public pour cette application ? : appuyez sur O.
   • Confirmez pour enregistrer toutes les configurations ci-dessus (O/N) : entrez O. Si vous entrez N, la configuration n’est pas enregistrée dans les fichiers POM.

2. 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:simple-todo-web-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
   [INFO]   InstanceName:simple-todo-web-default-x-xxxxxxxxx-xxxxx  Status:Terminating Reason:null       DiscoverStatus:UNREGISTERED
   [INFO] Getting public url of app(simple-todo-web)...
   [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io
   

   L’URL d’application de sortie est le point de terminaison permettant d’accéder à l’application todo.

Azure Developer CLI

Vous pouvez maintenant déployer l’application sur Azure Spring Apps. 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 :

1. 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.
   

2. 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-todo-web
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.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
   

   Le Point de terminaison de sortie est le point de terminaison permettant d’accéder à l’application todo.

Notes

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 Azure-Samples/ASA-Samples-Web-Application.

5. Valider l’application web

Vous pouvez maintenant accéder à l’application déployée pour voir si elle fonctionne.

Azure portal

Utilisez les étapes suivantes pour valider :

1. Une fois le déploiement terminé, vous pouvez rechercher l’URL de l’application à partir des sorties de déploiement :

   

2. Accédez à l’application avec l’URL de l’application de sortie. La page doit apparaître telle que vous l’avez vue dans localhost.

3. Consultez les détails de chaque déploiement de ressources, qui sont utiles pour examiner les problèmes de déploiement.

Portail Azure + plug-in Maven

Accédez à l’application avec l’URL de l’application de sortie. La page doit apparaître telle que vous l’avez vue dans localhost.

Azure CLI

Utilisez les étapes suivantes pour valider :

1. Une fois le déploiement terminé, vous pouvez accéder à l’application avec cette URL : https://${AZURE_SPRING_APPS_NAME}-${APP_NAME}.azuremicroservices.io/. La page doit apparaître telle que vous l’avez vue dans localhost.

2. Pour consulter le journal de l’application afin d’examiner tout problème de déploiement, utilisez la commande suivante :

   az spring app logs \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME}
   

Azure portal

Utilisez les étapes suivantes pour valider :

1. Une fois le déploiement terminé, vous pouvez rechercher l’URL de l’application à partir des sorties de déploiement :

   

2. Accédez à l’URL de l’application. La page doit apparaître telle que vous l’avez vue dans localhost.

3. Consultez les détails de chaque déploiement de ressources, qui sont utiles pour examiner les problèmes de déploiement.

Portail Azure + plug-in Maven

Accédez à l’application avec l’URL de l’application de sortie. La page doit apparaître telle que vous l’avez vue dans localhost.

Azure Developer CLI

Accédez à l’application avec le point de terminaison de sortie. La page doit apparaître telle que vous l’avez vue dans localhost.

Azure portal

Utilisez les étapes suivantes pour valider :

1. Une fois le déploiement terminé, recherchez l’URL de l’application à partir des sorties de déploiement :

   

2. Accédez à l’URL de l’application. La page doit apparaître telle que vous l’avez vue dans localhost.

3. Consultez les détails de chaque déploiement de ressources, qui sont utiles pour examiner les problèmes de déploiement.

Portail Azure + plug-in Maven

Accédez à l’application avec l’URL de l’application de sortie. La page doit apparaître telle que vous l’avez vue dans localhost.

Azure Developer CLI

Accédez à l’application avec le point de terminaison de sortie. La page doit apparaître telle que vous l’avez vue dans localhost.

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.

Azure portal

Procédez comme suit pour supprimer l’ensemble du groupe de ressources, y compris l’instance de service nouvellement créée :

1. 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.

2. 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.

Portail Azure + plug-in Maven

Procédez comme suit pour supprimer l’ensemble du groupe de ressources, y compris la nouvelle instance de service créée :

1. 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.

2. 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.

Azure Developer CLI

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 : <resources-total>, êtes-vous sûr de vouloir 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.

Azure portal

Procédez comme suit pour supprimer l’ensemble du groupe de ressources, y compris la nouvelle instance de service créée :

1. 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.

2. 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.

Portail Azure + plug-in Maven

Procédez comme suit pour supprimer l’ensemble du groupe de ressources, y compris la nouvelle instance de service créée :

1. 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.

2. 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.

Azure CLI

Pour supprimer l’intégralité du groupe de ressources, y compris le serveur que vous venez de créer, utilisez la commande suivante :

az group delete --name ${RESOURCE_GROUP}

7. Étapes suivantes

Journal des applications structuré pour Azure Spring Apps

Mapper un domaine personnalisé existant à Azure Spring Apps

Configurer Azure Spring Apps CI/CD avec GitHub Actions

Automatiser les déploiements d’applications dans Azure Spring Apps

Utiliser des identités managées pour les applications dans Azure Spring Apps

Démarrage rapide : Créer une connexion de service dans Azure Spring Apps avec Azure CLI

Présentation de l’exemple d’application

Présentation de l’exemple d’application Fitness Store

Pour plus d’informations, consultez les articles suivants :

• Exemples Azure Spring Apps.
• Azure pour les développeurs Spring
• Documentation Spring Cloud Azure