Démarrage rapide : lancer votre première application Java dans Azure Container Apps

Cet article vous montre comment déployer l'exemple d'application Spring PetClinic pour l'exécuter sur Azure Container Apps. Au lieu de créer manuellement un fichier Dockerfile et d’utiliser directement un registre de conteneurs, vous pouvez déployer votre application Java directement à partir d’un fichier Java Archive (JAR) ou WAR (Web Application Archive).

À la fin de ce tutoriel, vous avez déployé une application web, que vous pouvez gérer via le Portail Microsoft Azure.

L'image suivante est une capture d'écran de l'aspect de votre application une fois déployée sur Azure.

Prérequis

Condition requise	Instructions
Compte Azure	Si vous n’en avez pas un, créez un compte gratuitement. Vous avez besoin de l’autorisation Contributeur ou Propriétaire sur l’abonnement Azure pour continuer. Pour plus d’informations, consultez Attribuer des rôles Azure à l’aide du portail Azure.
Compte GitHub	Vous pouvez en obtenir un gratuitement.
git	Installez Git
Azure CLI	Installez Azure CLI.
Extension CLI de Container Apps	Utilisez la version 0.3.47 ou une version ultérieure. Utilisez la commande az extension add --name containerapp --upgrade --allow-preview pour installer la dernière version.
Java	Installer le kit de développement Java. Utilisez la version 17 ou ultérieure.
Maven	Installez le Maven.

Préparer le projet

Clonez l’exemple d’application Spring PetClinic sur votre machine.

git clone https://github.com/spring-projects/spring-petclinic.git

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

Créer le projet

Basculez vers le dossier spring-petclinic.

cd spring-petclinic

Nettoyez la zone de build Maven, compilez le code du projet et créez un fichier JAR, en ignorant les tests.

mvn clean package -DskipTests

Après avoir exécuté la commande de génération, un fichier nommé petclinic.jar est généré dans le dossier /cible.

Remarque

Si nécessaire, vous pouvez spécifier la version de Tomcat dans les variables d’environnement de génération Java.

Basculez vers le dossier spring-framework-petclinic.

cd spring-framework-petclinic

Nettoyez la zone de build Maven, compilez le code du projet et créez un fichier WAR, en ignorant les tests.

mvn clean package -DskipTests

Après avoir exécuté la commande de génération, un fichier nommé petclinic.war est généré dans le dossier /target.

Déployer le projet

Déployez le package JAR sur Azure Container Apps.

Remarque

Si nécessaire, vous pouvez spécifier la version de JDK dans les variables d’environnement de génération Java.

Vous pouvez maintenant déployer votre fichier WAR avec la commande CLI az containerapp up.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --subscription <SUBSCRIPTION_ID>\
  --location <LOCATION> \
  --environment <ENVIRONMENT_NAME> \
  --artifact <JAR_FILE_PATH_AND_NAME> \
  --ingress external \
  --target-port 8080 \
  --query properties.configuration.ingress.fqdn

Remarque

La version par défaut du JDK est la version 17. Si vous devez changer la version de JDK pour qu’elle soit compatible avec votre application, vous pouvez utiliser l’argument --build-env-vars BP_JVM_VERSION=<YOUR_JDK_VERSION> pour ajuster le numéro de version.

D’autres variables d’environnement de génération applicables se trouvent dans Variables d’environnement de génération Java.

Déployez le package WAR sur Azure Container Apps.

Vous pouvez maintenant déployer votre fichier WAR avec la commande CLI az containerapp up.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --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

Remarque

La version de Tomcat par défaut est 9. Si vous devez changer la version de Tomcat pour qu’elle soit compatible avec votre application, vous pouvez utiliser l’argument --build-env-vars BP_TOMCAT_VERSION=<YOUR_TOMCAT_VERSION> pour ajuster le numéro de version.

Dans cet exemple, la version de Tomcat est définie sur 10 (y compris les versions mineures) en définissant la variable d’environnement BP_TOMCAT_VERSION=10.*.

D’autres variables d’environnement de génération applicables se trouvent dans Variables d’environnement de génération Java.

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. Votre application doit ressembler à la capture d’écran suivante.

Étapes suivantes

Variables d’environnement de génération Java