Déployer une application Quarkus sur Azure Container Apps

• 10 minutes

Dans cette unité, vous créez l’environnement Azure Container Apps en utilisant Azure CLI.

Configurer le Dockerfile pour l’application Quarkus

La plateforme Container Apps est utilisée pour déployer des applications conteneurisées. Vous devez donc conteneuriser d’abord l’application Quarkus dans une image Docker. Ce processus est facile à faire, car le plug-in Quarkus Maven a déjà généré des fichiers Dockerfile sous src/main/docker.

Utilisez cette commande pour renommer l’un de ces fichiers Dockerfile Dockerfile.jvm en Dockerfile, puis déplacez-le vers le dossier racine :

mv src/main/docker/Dockerfile.jvm ./Dockerfile

Remplacez le contenu après le long commentaire dans le Dockerfile par ce qui suit :

FROM registry.access.redhat.com/ubi8/openjdk-17:1.18

ENV LANGUAGE='en_US:en'


# We make four distinct layers so if there are application changes the library layers can be re-used
COPY --chown=185 target/quarkus-app/lib/ /deployments/lib/
COPY --chown=185 target/quarkus-app/*.jar /deployments/
COPY --chown=185 target/quarkus-app/app/ /deployments/app/
COPY --chown=185 target/quarkus-app/quarkus/ /deployments/quarkus/

EXPOSE 8080
USER 185
ENV JAVA_OPTS_APPEND="-Dquarkus.http.host=0.0.0.0 -Djava.util.logging.manager=org.jboss.logmanager.LogManager"
ENV JAVA_APP_JAR="/deployments/quarkus-run.jar"

ENTRYPOINT [ "/opt/jboss/container/java/run/run-java.sh" ]

Ce Dockerfile s’attend à ce que l’application Quarkus soit empaquetée en tant que fichier quarkus-run.jar. Il s’agit du nom par défaut de l’application Quarkus lorsqu’elle est empaquetée en tant que fichier JAR. Vous devez vérifier que l’application Quarkus est empaquetée en tant que fichier JAR. Pour ce faire exécutez la commande Maven suivante :

./mvnw package    # On Mac or Linux
mvnw.cmd package  # On Windows

Cette commande met en package l’application Quarkus dans un fichier JAR et génère un fichier quarkus-run.jar dans le dossier target/quarkus-app.

Créer l’environnement Container Apps et déployer le conteneur

Maintenant que le Dockerfile se trouve dans le bon emplacement, vous pouvez créer l’environnement Container Apps et déployer le conteneur en utilisant une seule commande Azure CLI. Exécutez la commande suivante à la racine du projet :

az containerapp up \
    --name "$AZ_CONTAINERAPP" \
    --environment "$AZ_CONTAINERAPP_ENV" \
    --location "$AZ_LOCATION" \
    --resource-group "$AZ_RESOURCE_GROUP" \
    --ingress external \
    --target-port 8080 \
    --source .

Cette commande effectue plusieurs tâches :

• Elle crée un environnement Container Apps s’il n’existe pas
• Elle crée un registre Azure s’il n’existe pas
• Elle crée un espace de travail Log Analytics s’il n’existe pas
• Elle génère l’image Docker et l’envoie (push) au registre Azure
• Elle déploie l’image Docker dans l’environnement Container Apps

L’exécution de la commande az containerapp up prend du temps. Vous devriez voir une sortie semblable à ce qui suit :

Using resource group 'rgazure-deploy-quarkus'
Creating ContainerAppEnvironment 'caeazure-deploy-quarkus' in resource group rgazure-deploy-quarkus
No Log Analytics workspace provided.
Generating a Log Analytics workspace with name "workspace-rgazuredeployquarkusEED7"
Creating Azure Container Registry ca001ad52ae7acr in resource group rgazure-deploy-quarkus

Run ID: ca3 was successful after 41s
Creating Containerapp caazure-deploy-quarkus in resource group rgazure-deploy-quarkus
Adding registry password as a secret with name "ca001ad52ae7acrazurecrio-ca001nxc57acr"

Your container app caazure-deploy-quarkus has been created and deployed! Congrats! 

Valider le déploiement

Vous pouvez confirmer que le déploiement a réussi de plusieurs façons. Le moyen le plus simple consiste à rechercher votre groupe de ressources dans le Portail Azure. Vous devez voir des ressources similaires à celles-ci :

Vous pouvez également vérifier le déploiement en exécutant la commande suivante. Elle répertorie toutes les ressources créées par la commande az containerapp up.

az resource list \
    --location "$AZ_LOCATION" \
    --resource-group "$AZ_RESOURCE_GROUP" \
    --output table

Vous devriez voir une sortie semblable à ce qui suit :

Name                                ResourceGroup           Location    Type                                       Status
----------------------------------  ----------------------  ----------  -----------------------------------------  --------
caea3a6e0afeacr                     rgazure-deploy-quarkus  eastus      Microsoft.ContainerRegistry/registries
psqlazure-deploy-quarkus            rgazure-deploy-quarkus  eastus      Microsoft.DBforPostgreSQL/flexibleServers
caazure-deploy-quarkus              rgazure-deploy-quarkus  eastus      Microsoft.App/containerApps
caeazure-deploy-quarkus             rgazure-deploy-quarkus  eastus      Microsoft.App/managedEnvironments
workspace-rgazuredeployquarkuscDD3  rgazure-deploy-quarkus  eastus      Microsoft.OperationalInsights/workspaces

Exécuter l’application Quarkus déployée

Vous pouvez maintenant exécuter l’application Quarkus déployée. Tout d’abord, vous devez obtenir l’URL de l’application. Vous pouvez l’obtenir en exécutant la commande suivante :

export AZ_APP_URL=$(
    az containerapp show \
        --name "$AZ_CONTAINERAPP" \
        --resource-group "$AZ_RESOURCE_GROUP" \
        --query "properties.configuration.ingress.fqdn" \
        --output tsv \
)

echo "AZ_APP_URL=$AZ_APP_URL"

Votre application est prête à l’adresse https://<app-name>.azurecontainerapps.io/. Notez l’usage du protocole https. Ce protocole est utilisé, car l’application est déployée avec un certificat TLS. Pour tester l’application, vous pouvez utiliser cURL :

curl --header "Content-Type: application/json" \
    --request POST \
    --data '{"description":"Configuration","details":"Congratulations, you have set up your Quarkus application correctly!","done": "true"}' \
    https://$AZ_APP_URL/api/todos

Récupérez les données en utilisant une nouvelle requête cURL :

curl https://$AZ_APP_URL/api/todos

Cette commande retourne la liste de toutes les tâches de la base de données :

[
   {
      "description" : "Take Quarkus MS Learn",
      "details" : "Take the MS Learn on deploying Quarkus to Azure Container Apps",
      "done" : true,
      "id" : 1
   },
   {
      "description" : "Take Azure Container MS Learn",
      "details" : "Take the ACA Learn module",
      "done" : false,
      "id" : 2
   },
   {
      "description" : "Configuration",
      "details" : "Congratulations, you have set up your Quarkus application correctly!",
      "done" : true,
      "id" : 3
   }
]

Lorsque vous exécutez cette commande, vous pouvez diffuser en continu les journaux de votre conteneur quand vous créez des tâches :

az containerapp logs show \
    --name "$AZ_CONTAINERAPP" \
    --resource-group "$AZ_RESOURCE_GROUP" \
    --follow

Exécutez d’autres commandes cURL. Vous devriez voir les journaux défiler dans le terminal.

curl https://$AZ_APP_URL/api/todos