Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 :
Prérequis
- Un abonnement Azure. Créez-en un gratuitement.
- Autorisation de
Contributor
ouOwner
sur l’abonnement approprié. Pour plus d’informations, consultez Attribuer des rôles Azure en utilisant le portail Azure. - Un compte GitHub.
- Git
- Azure CLI
- Extension CLI Azure Container Apps, version 0.3.47 ou ultérieure. Utilisez la commande suivante pour installer la dernière version :
az extension add --name containerapp --upgrade --allow-preview
- Kit de développement Java, version 17 ou ultérieure.
- Apache Maven
Créer le projet
Générez le projet en procédant comme suit :
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
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
Accédez au dossier spring-petclinic à l’aide de la commande suivante :
cd azure-container-apps-java-samples/spring-petclinic/spring-petclinic/
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
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 .
Accédez au dossier spring-framework-petclinic à l’aide de la commande suivante :
cd spring-framework-petclinic
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>