Partager via


Démarrage rapide : Générer et déployer sur une application web Java

Azure DevOps Services

Dans ce guide de démarrage rapide, vous allez créer un pipeline Azure qui génère et déploie une application Java sur Azure App Service sur Linux. Lorsque vous avez terminé, vous disposez d’un pipeline CI/CD opérationnel qui génère et déploie automatiquement votre application chaque fois que vous envoyez des modifications à votre référentiel.

Vous pouvez utiliser Tomcat ou Java SE comme runtime.

Conseil / Astuce

Si vous souhaitez uniquement créer une application Java, consultez Créer des applications Java.

Conditions préalables

Produit Exigences
Azure DevOps - Un projet Azure DevOps .
- Possibilité d’exécuter des pipelines sur des agents hébergés par Microsoft. Vous pouvez acheter un travail parallèle ou demander un niveau gratuit.
- Connaissance de base de YAML et d’Azure Pipelines. Pour plus d’informations, consultez Créer votre premier pipeline.
- Autorisations :
     - Pour créer un pipeline : vous devez être dans le groupe Contributeurs et le groupe doit avoir l'autorisation Créer un pipeline de build réglée sur Autoriser. Les membres du groupe Administrateurs de projet peuvent gérer les pipelines.
    - Pour créer des connexions de service : vous devez avoir le rôle Administrateur ou Créateur pour les connexions de service.
Lien avec GitHub - Un compte GitHub .
- Connexion de service GitHub pour autoriser Azure Pipelines.
Microsoft Azure Un abonnement Azure.
Produit Exigences
Azure DevOps - Un projet Azure DevOps .
- Un agent auto-hébergé. Pour en créer un, consultez les agents auto-hébergés.
- Connaissance de base de YAML et d’Azure Pipelines. Pour plus d’informations, consultez Créer votre premier pipeline.
- Autorisations :
    - Pour créer un pipeline : vous devez être dans le groupe Contributeurs et le groupe doit avoir l'autorisation Créer un pipeline de build réglée sur Autoriser. Les membres du groupe Administrateurs de projet peuvent gérer les pipelines.
    - Pour créer des connexions de service : vous devez avoir le rôle Administrateur ou Créateur pour les connexions de service.
Lien avec GitHub - Un compte GitHub .
- Connexion de service GitHub pour autoriser Azure Pipelines.
Microsoft Azure Un abonnement Azure.

Obtenir le code

Sélectionnez le runtime que vous souhaitez utiliser.

Si vous disposez déjà d’une application dans GitHub que vous souhaitez déployer, vous pouvez créer un pipeline pour ce code.

Si vous êtes un nouvel utilisateur, fork ce dépôt dans GitHub :

https://github.com/spring-petclinic/spring-framework-petclinic

Créer un plan App Service et une application

Connectez-vous au portail Azure, puis sélectionnez le bouton Cloud Shell en haut à droite.

Créez un plan App Service et une application web sur Linux.

# Create a resource group to organize and manage related Azure resources
az group create --location eastus2 --name myapp-rg

# Create an App Service plan with Linux as the operating system
# The plan defines the compute resources for your web app
az appservice plan create -g myapp-rg -n myapp-service-plan --is-linux

# Create a web app using the App Service plan
# Configure Tomcat 10.1 with Java 17 as the runtime environment
az webapp create -g myapp-rg -p myapp-service-plan -n my-app-name --runtime "TOMCAT|10.1-java17"

Créer le pipeline

  1. Dans votre projet Azure DevOps, sélectionnez Pipelines dans le menu de navigation de gauche.

  2. Sélectionnez Nouveau pipeline ou Créer un pipeline si ce pipeline est le premier dans le projet.

  3. Dans l’écran Où se trouve votre code , sélectionnez GitHub.

  4. Vous serez peut-être redirigé vers GitHub pour vous connecter. Si c’est le cas, entrez vos informations d’identification GitHub.

  5. Dans l’écran Sélectionner un référentiel , sélectionnez le référentiel dans lequel se trouve votre application .NET.

  6. Vous serez peut-être redirigé vers GitHub pour pouvoir installer l’application Azure Pipelines. Si c’est le cas, sélectionnez Approuver et installer.

Configurer le pipeline

  1. Lorsque l’onglet Configurer s’affiche, sélectionnez Afficher plus, puis sélectionnez Application web de projet Java du package Maven sur Linux sur Azure.

  2. Vous pouvez créer automatiquement une connexion de service Azure Resource Manager lorsque vous créez votre pipeline. Pour commencer, sélectionnez votre abonnement Azure dans lequel vous avez créé un groupe de ressources.

  3. Sélectionnez Valider et configurer. Le nouveau pipeline inclut une nouvelle connexion de service Azure Resource Manager.

    Comme Azure Pipelines crée un fichier azure-pipelines.yml, qui définit votre pipeline CI/CD, il :

    • Inclut une phase de génération, qui génère votre projet et une phase de déploiement, qui la déploie sur Azure en tant qu’application web Linux.
    • Dans le cadre de la phase de déploiement, il crée également un environnement portant le même nom que l’application web. Vous pouvez choisir de modifier le nom de l’environnement.
  4. Vérifiez que toutes les entrées par défaut sont adaptées à votre code.

  5. Sélectionnez Enregistrer et exécuter. Vous êtes invité à entrer un message de validation, car le fichier azure-pipelines.yml est ajouté à votre référentiel. Après avoir modifié le message, sélectionnez Enregistrer et réexécuter pour afficher votre pipeline en action.

Vérifier le déploiement

À mesure que votre pipeline s’exécute, vos index de build et de déploiement passent de bleu (en cours d’exécution) à vert (terminé). Pour surveiller votre pipeline en action, sélectionnez des étapes et des travaux.

Une fois le pipeline exécuté, vérifiez que votre application est en cours d’exécution en accédant à votre site :

https://my-app-name.azurewebsites.net/petclinic

Pour explorer l’historique de déploiement de l’application, accédez à l’environnement. À partir du résumé du pipeline :

  1. Cliquez sur l’onglet environnements.
  2. Sélectionnez Voir l’environnement.

Nettoyer les ressources

Chaque fois que vous avez terminé d’utiliser les ressources que vous avez créées, vous pouvez utiliser la commande suivante pour les supprimer :

az group delete --name myapp-rg

Entrez y lorsqu'on vous le demande.

Résumé

Vous avez créé un pipeline Azure qui génère et déploie automatiquement une application Java sur App Service. Toutes les modifications que vous envoyez (push) à votre référentiel déclenchent désormais le pipeline pour générer et déployer votre application mise à jour.