Guide pratique pour déployer des applications Spring Boot à partir d’Azure CLI

Article
10/04/2024

Remarque

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

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

Cet article s’applique à : ✔️ Java ❌ C#

Cet article s’applique au : Niveau ✔️ De base/Standard ❌️ Entreprise

Azure Spring Apps permet d’avoir des applications Spring Boot sur Azure.

Vous pouvez lancer des applications directement à partir du code source Java ou d’un fichier JAR prédéfini. Cet article explique les procédures de déploiement.

Prérequis

Avant de commencer, vérifiez que votre abonnement Azure a les dépendances requises :

Conseil

Azure Cloud Shell est un interpréteur de commandes interactif et gratuit que vous pouvez utiliser pour exécuter les étapes de cet article. Les outils Azure les plus courants sont préinstallés, notamment les dernières versions de Git, JDK, Maven et Azure CLI. Si vous êtes connecté à votre abonnement Azure, lancez Azure Cloud Shell à partir de shell.azure.com. Pour en savoir plus sur Azure Cloud Shell, consultez notre documentation.

Installer l’extension Azure CLI

Installez l’extension Azure Spring Apps pour Azure CLI avec la commande suivante.

az extension add --name spring

Provisionner une instance de service à l’aide d’Azure CLI

Connectez-vous à Azure CLI et choisissez votre abonnement actif.

az login
az account list -o table
az account set --subscription <subscription-id>

Créez un groupe de ressources destiné à contenir votre service dans Azure Spring Apps. Vous pouvez en apprendre davantage sur les groupes de ressources Azure.

az group create --location eastus --name <resource-group-name>

Exécutez les commandes suivantes pour provisionner une instance d’Azure Spring Apps. Préparez un nom pour votre service dans 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.

az spring create --resource-group <resource-group-name> --name <resource-name>

Le déploiement de l’instance de service prend environ cinq minutes.

Définissez le nom du groupe de ressources et le nom de l’instance Azure Spring Apps par défaut en exécutant les commandes suivantes :

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

Créer l’application dans Azure Spring Apps

La commande suivante crée une application dans Azure Spring Apps, dans votre abonnement. Elle crée un service vide dans lequel vous pouvez charger votre application.

az spring app create --name <app-name>

Déployer votre application Spring Boot

Vous pouvez déployer votre application à partir d’un fichier JAR prédéfini ou d’un référentiel Gradle ou Maven. Vous trouverez ci-dessous des instructions pour chaque cas.

Déployer un fichier JAR prédéfini

Pour effectuer un déploiement à partir d’un fichier JAR généré sur votre ordinateur local, vérifiez que votre build produit un fichier fat-JAR.

Pour déployer le fichier fat-JAR dans un déploiement actif :

az spring app deploy --name <app-name> --artifact-path <path-to-fat-JAR>

Pour déployer le fichier fat-JAR dans un déploiement spécifique :

az spring app deployment create --app <app-name> \
    --name <deployment-name> \
    --artifact-path <path-to-fat-JAR>

Déployer à partir de code source

Azure Spring Apps utilise kpack pour générer votre projet. Vous pouvez utiliser Azure CLI pour charger votre code source, générer votre projet à l’aide de kpack, et le déployer dans l’application cible.

Avertissement

Le projet ne doit produire qu’un seul fichier JAR avec une entrée main-class dans le MANIFEST.MF de target (pour les déploiements Maven) ou build/libs (pour les déploiements Gradle). La présence de plusieurs fichiers JAR avec des entrées main-class entraînent l’échec du déploiement.

Pour les projets Maven/Gradle à un seul module :

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path

Pour les projets Maven/Gradle avec plusieurs modules, répétez cette opération pour chaque module :

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path \
    --target-module <relative-path-to-module>

Afficher les journaux de déploiement

Passez en revue les journaux de génération kpack à l’aide de la commande suivante :

az spring app show-deploy-log --name <app-name>

Notes

Les journaux kpack affichent uniquement le dernier déploiement si celui-ci a été généré à partir de la source à l’aide de kpack.

Attribuer un point de terminaison public à une application

Ouvrez le volet Applications pour afficher les applications de votre instance de service.
Sélectionnez une application pour afficher sa page Vue d’ensemble.
Sélectionnez Attribuer un point de terminaison pour affecter un point de terminaison public à l’application. Ce processus peut prendre plusieurs minutes.
Copiez l’URL à partir de la page Vue d’ensemble et collez-la dans votre navigateur pour afficher l’application en cours d’exécution.

Étapes suivantes

Démarrage rapide : Monitoring d’Azure Spring Apps avec les journaux, les métriques et le suivi

D’autres exemples sont disponibles sur GitHub : Exemples Azure Spring Apps.

Partager via