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

Article
09/04/2023

Notes

Les 50 premières heures de processeur virtuel et 100 Go de mémoire sont gratuites chaque mois. Pour plus d’informations, consultez Price Reduction - Azure Spring Apps does more, costs less! sur le blog Apps on Azure.

Notes

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

Cet article 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 que vous aurez terminé cet exemple, l’application est accessible en ligne. Vous pourrez la gérer sur le Portail Azure.

Cet article décrit les deux options suivantes pour le déploiement sur Azure Spring Apps :

Le portail Azure est un moyen plus conventionnel de créer des ressources et de déployer des applications pas à pas. Il convient aux développeurs Spring qui utilisent les services cloud Azure pour la première fois.
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. Il couvre le code d’application et l’infrastructure en tant que fichiers de code nécessaires pour approvisionner les ressources Azure. Il convient aux développeurs Spring qui sont familiarisés avec les services cloud Azure.

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

Un abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.
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.
Git.
Kit de développement Java (JDK), version 17.
Azure CLI version 2.45.0 ou ultérieure.

2. Préparer le projet Spring

Azure portal
Azure Developer CLI

Suivez la procédure ci-dessous pour préparer le projet :

Utilisez la commande suivante pour cloner l’exemple de projet Spring Boot pour Azure à partir de GitHub.
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
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
```

Suivez la procédure ci-dessous pour initialiser l’application depuis les modèles Azure Developer CLI :

Ouvrez une fenêtre de terminal, créez un nouveau dossier, puis changez le répertoire dans ce dossier.

Utilisez la commande ci-dessous pour initialiser le projet :

azd init --template spring-guides/gs-spring-boot-for-azure

La liste suivante décrit les interactions de commande :

Entrez un nouveau nom d’environnement : fournissez un nom d’environnement, qui est utilisé comme suffixe pour le groupe de ressources créé pour contenir toutes les ressources Azure. Ce nom doit être unique dans votre abonnement Azure.

La console génère des messages similaires à l’exemple suivant :

Initializing a new project (azd init)

(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice

3. Préparer l’environnement cloud

Une instance Azure Spring Apps est la principale ressource dont vous avez besoin pour exécuter cet exemple. Exécutez les étapes suivantes pour créer cette ressource.

Azure portal
Azure Developer CLI

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 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.
Resource group	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.
Plan	Consommation standard & dédiée (préversion)	Le plan tarifaire détermine les ressources et le coût associés à votre instance.
Region	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.
- Charge de travail de consommation
- Charge de travail dédiée
1. Renseignez l’onglet Informations de base avec les informations suivantes :
  - Nom de l’environnement : myacaenv
  - Plan : Consommation
  - Redondance de zone : désactivée
2. Sélectionnez Créer pour créer l’Environnement Container Apps.
1. 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
2. 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.
3. 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
4. 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.

Utilisez la commande suivante pour vous connecter à Azure avec OAuth2. Ignorez cette étape si vous êtes déjà connecté.
```
azd auth login
```
La console génère des messages similaires à l’exemple suivant :
```
Logged in to Azure.
```
Utilisez la commande suivante pour approvisionner l’infrastructure du modèle sur Azure :
```
azd provision
```
La liste suivante décrit les interactions de commande :
- Sélectionnez un abonnement Azure à utiliser : utilisez les flèches pour vous déplacer, tapez 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/<your-resource-group>/overview
```
Notes

Cette opération peut prendre un certain temps. Un indicateur de progression vous indiquera l’approvisionnement des ressources Azure.

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

Cette section décrit les étapes à suivre pour déployer votre application sur Azure Spring Apps.

Azure portal
Azure Developer CLI

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

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.18.0:config
```
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.
- 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.
- Entrez le nom de l’application : indiquez un nom d’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 (O/N) : entrez O. 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 com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0: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 updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running 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 à 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

Notes

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.

2. Préparer le projet Spring

Azure portal
Azure Developer CLI

Suivez la procédure ci-dessous pour préparer le projet :

Utilisez la commande suivante pour cloner l’exemple de projet Spring Boot pour Azure à partir de GitHub.
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
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
```

Suivez la procédure ci-dessous pour initialiser l’application à partir des modèles Azure Developer CLI.

Ouvrez une fenêtre de terminal, créez un nouveau dossier et changez le répertoire dans ce dossier.

Utilisez la commande ci-dessous pour initialiser le projet :

azd init --template spring-guides/gs-spring-boot-for-azure

La liste suivante décrit les interactions de commande :

Entrez un nouveau nom d’environnement : fournissez un nom d’environnement, qui est utilisé comme suffixe pour le groupe de ressources créé pour contenir toutes les ressources Azure. Ce nom doit être unique dans votre abonnement Azure.

La console génère des messages similaires à l’exemple suivant :

Initializing a new project (azd init)

(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice

3. Préparer l’environnement cloud

Une instance Azure Spring Apps est la principale ressource dont vous avez besoin pour exécuter cet exemple. Exécutez les étapes suivantes pour créer cette ressource.

Azure portal
Azure Developer CLI

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.
Resource group	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.
Plan	Standard	Plan tarifaire qui détermine la ressource et le coût associés à votre instance.
Region	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.

Utilisez la commande suivante pour vous connecter à Azure avec OAuth2. Ignorez cette étape si vous êtes déjà connecté.
```
azd auth login
```
La console génère des messages similaires à l’exemple suivant :
```
Logged in to Azure.
```
Utilisez la commande suivante pour définir le modèle à l’aide du plan Standard :
```
azd env set PLAN standard
```
Utilisez la commande suivante pour empaqueter une copie déployable de votre application, approvisionner l’infrastructure du modèle sur Azure et déployer le code de l’application sur les nouvelles ressources approvisionnées :
```
azd provision
```
La liste suivante décrit les interactions de commande :
- Sélectionnez un abonnement Azure à utiliser : utilisez les flèches pour vous déplacer, tapez 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/<your-resource-group>/overview
```
Notes

Cette opération 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

Cette section décrit les étapes à suivre pour déployer votre application sur Azure Spring Apps.

Azure portal
Azure Developer CLI

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

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.18.0:config
```
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.
- 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.
- Entrez le nom de l’application : indiquez un nom d’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 (O/N) : entrez O. 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 com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:deploy

La liste suivante décrit les interactions 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 updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running 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

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 la page spring-guides/gs-spring-boot-for-azure.

2. Préparer le projet Spring

Suivez la procédure ci-dessous pour préparer le projet :

Utilisez la commande suivante pour cloner l’exemple de projet Spring Boot pour Azure à partir de GitHub.
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
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 :

curl https://start.spring.io/starter.tgz -d dependencies=web -d baseDir=demo -d bootVersion=3.0.0 -d javaVersion=17 -d type=maven-project -d groupId=com.example -d artifactId=demo -d name=demo -d packageName=com.example.demo -d packaging=jar | tar -xzvf -

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
```

3. Préparer l’environnement cloud

Utilisez les étapes suivante pour créer une instance de service 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.

export LOCATION="<region>"
export RESOURCE_GROUP="<resource-group-name>"
export SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
export APP_NAME="demo"

3.2. Création d’un groupe de ressources

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 :

Notes

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.

Diagramme montrant la relation entre des applications et une instance de service Azure Spring Apps.

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

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.
Resource group	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.
Plan	Entreprise	Plan tarifaire qui détermine la ressource et le coût associés à votre instance.
Region	La région la plus proche de vos utilisateurs	L’emplacement géographique le plus proche de vos utilisateurs.
Redondant interzone	Désactivé	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.
Plan IP logiciel	Paiement à l’utilisation	Plan de paiement à l’utilisation pour Azure Spring Apps.
Termes	Volumes sélectionnés	Vous devez activer la case à cocher du contrat associée à l’offre de la Place de marché.

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.

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

Cette section décrit les étapes à suivre pour déployer votre application sur Azure Spring Apps.

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.

4.1. Importer le projet

Suivez la procédure ci-dessous pour importer le projet :

Ouvrez IntelliJ IDEA, puis 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 :

Si vous n’avez pas déjà installé Azure Toolkit for IntelliJ, suivez la procédure décrite dans Installation d’Azure Toolkit for IntelliJ.

Notes

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.

5. Valider l’application

Vous pouvez accéder à l’application sur https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io après le 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.

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}

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. Pour supprimer les ressources, supprimez simplement le groupe de ressources qui les contient. Vous pouvez supprimer le groupe de ressources à l’aide du portail Azure. Pour supprimer le groupe de ressources à l’aide de l’interface Azure CLI, vous pouvez également utiliser la commande suivante :

az group delete --name ${RESOURCE_GROUP}

Vous pouvez supprimer le groupe de ressources Azure qui inclut toutes les ressources du groupe de ressources.

Azure portal
Azure Developer CLI

Pour supprimer l’intégralité du groupe de ressources, y compris le serveur que vous venez de créer, utilisez les étapes suivantes :

Localisez votre groupe de ressources dans le portail Azure. Dans le menu de navigation, sélectionnez Groupes de ressources. Sélectionnez ensuite le nom de votre groupe de ressources (par exemple, myresourcegroup).
Dans la page de votre groupe de ressources, sélectionnez Supprimer. Entrez le nom de votre groupe de ressources dans la zone de texte pour confirmer la suppression (par exemple, myresourcegroup), puis sélectionnez Supprimer.

Utilisez la commande suivante pour supprimer toutes les ressources Azure utilisées dans cet exemple d’application :

azd down

La liste suivante décrit les interactions de commande :

Total des ressources à supprimer : <your-resources-total>, voulez-vous vraiment continuer ? : appuyez sur o.

La console génère des messages similaires à l’exemple suivant :

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.

7. Étapes suivantes

Journal des applications structuré pour Azure Spring Apps

Mapper un domaine personnalisé existant à Azure Spring Apps

Utiliser CI/CD Azure Spring Apps 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

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 :

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

1. Prérequis

2. Préparer le projet Spring

3. Préparer l’environnement cloud

3.2. Créer une instance Azure Spring Apps

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

2. Préparer le projet Spring

3. Préparer l’environnement cloud

3.2. Créer une instance Azure Spring Apps

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

2. Préparer le projet Spring

3. Préparer l’environnement cloud

3.1. Donner des noms à chaque ressource

3.2. Création d’un groupe de ressources

3.3. Installer l’extension et inscrire l’espace de noms

3.4. Créer une instance Azure Spring Apps

3.5. Création d’une application dans l’instance Azure Spring Apps

3.2. Créer une instance Azure Spring Apps

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

4.1. Importer le projet

4.2. Créer et déployer votre application

5. Valider l’application

6. Nettoyer les ressources

7. Étapes suivantes

Ressources supplémentaires

Ressources supplémentaires

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

1. Prérequis

2. Préparer le projet Spring

3. Préparer l’environnement cloud

3.1. Connectez-vous au portail Azure.

3.2. Créer une instance Azure Spring Apps

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

2. Préparer le projet Spring

3. Préparer l’environnement cloud

3.1. Connectez-vous au portail Azure.

3.2. Créer une instance Azure Spring Apps

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

2. Préparer le projet Spring

3. Préparer l’environnement cloud

3.1. Donner des noms à chaque ressource

3.2. Création d’un groupe de ressources

3.3. Installer l’extension et inscrire l’espace de noms

3.4. Créer une instance Azure Spring Apps

3.5. Création d’une application dans l’instance Azure Spring Apps

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

5. Valider l’application

6. Nettoyer les ressources

7. Étapes suivantes

Ressources supplémentaires

Ressources supplémentaires