Générer et envoyer (push) une image à partir d’une application à l’aide d’un Cloud Native Buildpack

Article
10/31/2023

La commande Azure CLI az acr pack build utilise l'outil CLI pack, de Buildpacks, pour générer une application et envoyer son image dans un registre de conteneurs Azure. Cette fonctionnalité fournit une option permettant de créer rapidement une image conteneur à partir du code source de votre application dans Node.js, Java et d’autres langages sans avoir à définir un fichier dockerfile.

Pour utiliser les exemples de cet article, vous pouvez utiliser Azure Cloud Shell ou une installation locale d’Azure CLI. Si vous souhaitez l’utiliser en local, la version 2.0.70 ou ultérieure est requise. Exécutez az --version pour trouver la version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.

Important

Actuellement, cette fonctionnalité est uniquement disponible en tant que version préliminaire. Les préversions sont à votre disposition, à condition que vous acceptiez les conditions d’utilisation supplémentaires. Certains aspects de cette fonctionnalité sont susceptibles d’être modifiés avant la mise à disposition générale.

Utiliser la commande Build

Pour générer et envoyer (push) une image de conteneur à l’aide de Cloud Native Buildpacks, exécutez la commande az acr pack build. Tandis que la commande az acr build génère et envoie (push) une image à partir d’une source fichier dockerfile et du code associé, avec az acr pack build vous spécifiez directement une arborescence source d’application.

Au minimum, spécifiez les éléments suivants lorsque vous exécutez az acr pack build :

Un registre de conteneurs Azure dans lequel vous exécutez la commande
Un nom d’image et étiquette pour l’image résultante
L’un des emplacements de contexte pris en charge pour les tâches ACR, comme un répertoire local, un GitHub référentiel ou un tarball distant
Le nom d’une image de générateur Buildpack appropriée pour votre application. S’il n’est pas mis en cache par Azure Container Registry, l’image du générateur doit être extraite à l’aide du paramètre --pull.

az acr pack build prend en charge d’autres fonctionnalités des commandes de tâches ACR, notamment les variables d’exécution et les journaux d’exécution des tâches qui sont diffusés en continu et également enregistrés pour une récupération ultérieure.

Exemple : générer une image Node.js avec le générateur Cloud Foundry

L’exemple suivant génère une image conteneur à partir d’une application Node.js dans le référentiel Azure-Samples/nodejs-docs-hello-world à l’aide du générateur cloudfoundry/cnb:cflinuxfs3.

az acr pack build \
    --registry myregistry \
    --image node-app:1.0 \
    --pull --builder cloudfoundry/cnb:cflinuxfs3 \
    https://github.com/Azure-Samples/nodejs-docs-hello-world.git

Cet exemple génère l'image node-app avec la balise 1.0 et l'envoie (push) au registre de conteneurs myregistry. Dans cet exemple, le nom du registre cible est explicitement ajouté au nom de l’image. S’il n’est pas spécifié, le nom du serveur de connexion au registre est automatiquement ajouté au nom de l’image.

La sortie de la commande affiche la progression de la génération et de l’envoi de l’image.

Une fois l’image créée, vous pouvez l’exécuter avec Docker, si vous l’avez installé. Connectez-vous d’abord à votre registre :

az acr login --name myregistry

Exécuter l’image :

docker run --rm -p 1337:1337 myregistry.azurecr.io/node-app:1.0

Accédez à localhost:1337 dans votre navigateur favori pour voir l’exemple d’application Web. Appuyez sur [Ctrl]+[C] pour arrêter le conteneur.

Exemple : générer une image Java avec le générateur Heroku

L’exemple suivant génère une image conteneur à partir de l’application Java dans le référentiel buildpack/sample-java-App, à l’aide du générateur heroku/buildpacks:18.

az acr pack build \
    --registry myregistry \
    --image java-app:{{.Run.ID}} \
    --pull --builder heroku/buildpacks:18 \
    https://github.com/buildpack/sample-java-app.git

Cet exemple génère l'image java-app marquée avec l’ID d’exécution de la commande et l'envoie (push) au registre de conteneurs myregistry.

La sortie de la commande affiche la progression de la génération et de l’envoi de l’image.

Une fois l’image créée, vous pouvez l’exécuter avec Docker, si vous l’avez installé. Connectez-vous d’abord à votre registre :

az acr login --name myregistry

Exécutez l’image en remplaçant la balise d'image pour runid :

docker run --rm -p 8080:8080 myregistry.azurecr.io/java-app:runid

Accédez à localhost:8080 dans votre navigateur favori pour voir l’exemple d’application Web. Appuyez sur [Ctrl]+[C] pour arrêter le conteneur.

Étapes suivantes

Une fois que vous avez généré et envoyé une image conteneur avec az acr pack build, vous pouvez la déployer comme n’importe quelle image vers une cible de votre choix. Les options de déploiement Azure incluent l'exécution de cette opération dans App Service ou le Azure Kubernetes Service, entre autres.

Pour plus d’informations sur les fonctionnalités des tâches ACR, consultez Automatiser les builds d’image de conteneur et la maintenance avec les tâches ACR.

Partager via