Partager via


Démarrage rapide : Lancer votre première application Java dans Azure Container Apps à l’aide d’un fichier WAR ou JAR

Cet article explique comment déployer l’exemple d’application Spring PetClinic sur Azure Container Apps à l’aide d’un fichier WAR (Web Application Archive) ou d’un fichier JAR (Java Archive).

Il existe plusieurs options disponibles pour le déploiement d’applications Java, notamment les options suivantes :

  • Déploiement à partir d’un système de fichiers local ou à partir d’un référentiel de code.
  • Déploiement à l’aide de Maven ou d’un IDE.
  • Déploiement à l’aide d’un fichier WAR, d’un fichier JAR ou directement à partir du code source.

À la fin de ce tutoriel, vous déployez une application web que vous pouvez gérer via le portail Azure. La capture d’écran suivante montre la page d’accueil de l’application PetClinic déployée sur Azure Container Apps :

Capture d’écran de la page d’accueil de l’application PetClinic.

Prérequis

Créer le projet

Générez le projet en procédant comme suit :

  1. Clonez le dépôt d’exemples Java Azure Container Apps à l’aide de la commande suivante :

    git clone https://github.com/Azure-Samples/azure-container-apps-java-samples.git
    
  1. Clonez le dépôt d’exemple d’application Spring PetClinic à l’aide de la commande suivante :

    git clone https://github.com/spring-petclinic/spring-framework-petclinic.git
    
  1. Accédez au dossier spring-petclinic à l’aide de la commande suivante :

    cd azure-container-apps-java-samples/spring-petclinic/spring-petclinic/
    
  2. Initialisez et mettez à jour le référentiel d’exemples d’application Spring PetClinic vers la dernière version à l’aide de la commande suivante :

    git submodule update --init --recursive
    
  3. Utilisez la commande suivante pour nettoyer la zone de build Maven, compiler le code du projet et créer un fichier JAR, en ignorant tous les tests pendant ces processus :

    mvn clean verify
    

Vous disposez maintenant d’un fichier /target/petclinic.jar .

  1. Accédez au dossier spring-framework-petclinic à l’aide de la commande suivante :

    cd spring-framework-petclinic
    
  2. Utilisez la commande suivante pour nettoyer la zone de build Maven, compiler le code du projet et créer un fichier JAR, en ignorant tous les tests pendant ces processus :

    mvn clean verify
    

Vous disposez maintenant d’un fichier /target/petclinic.war .

Déployer le projet

Déployez le package JAR sur Azure Container Apps à l’aide de la commande suivante :

Remarque

La version par défaut du JDK est la version 17. Vous avez la possibilité de spécifier la version à l’aide de variables d’environnement. Pour modifier la version JDK pour la compatibilité avec votre application, utilisez l’argument --build-env-vars BP_JVM_VERSION=<your-JDK-version> . Pour plus d’informations, consultez Générer des variables d’environnement pour Java dans Azure Container Apps (préversion).

az containerapp up \
    --resource-group <resource-group> \
    --name <container-app-name> \
    --subscription <subscription-ID>\
    --location <location> \
    --environment <environment-name> \
    --artifact <JAR-file-path-and-name> \
    --ingress external \
    --target-port 8080 \
    --query properties.configuration.ingress.fqdn

Déployez le fichier WAR sur Azure Container Apps à l’aide de la commande suivante :

Remarque

La version de Tomcat par défaut est 9. Pour modifier la version pour la compatibilité avec votre application, utilisez l’argument --build-env-vars BP_TOMCAT_VERSION=<your-Tomcat-version> . Dans cet exemple, la version de Tomcat est définie sur 10 ( y compris les versions mineures ) en définissant BP_TOMCAT_VERSION=10.*. Pour plus d’informations, consultez Générer des variables d’environnement pour Java dans Azure Container Apps (préversion).

az containerapp up \
    --resource-group <resource-group> \
    --name <container-app-name> \
    --subscription <subscription>\
    --location <location> \
    --environment <environment-name> \
    --artifact <WAR-file-path-and-name> \
    --build-env-vars BP_TOMCAT_VERSION=10.* \
    --ingress external \
    --target-port 8080 \
    --query properties.configuration.ingress.fqdn

Vérifier l’état de l’application

Dans cet exemple, la commande containerapp up inclut l’argument --query properties.configuration.ingress.fqdn, qui renvoie le nom de domaine complet (FQDN), également appelé URL de l’application.

Consultez l’application en collant cette URL dans un navigateur.

Nettoyer les ressources

Si vous envisagez de continuer à utiliser des guides de démarrage rapide et des didacticiels supplémentaires, vous souhaiterez peut-être laisser ces ressources en place. Lorsque vous n’avez plus besoin des ressources, vous pouvez les supprimer pour éviter les frais Azure, à l’aide de la commande suivante :

az group delete --name <resource-group>