Didacticiel : Déployer et utiliser Azure Container RegistryTutorial: Deploy and use Azure Container Registry

Azure Container Registry (ACR) est un registre privé destiné d’images de conteneur.Azure Container Registry (ACR) is a private registry for container images. Un registre de conteneurs privé vous permet de générer et déployer vos applications et codes personnalisés en toute sécurité.A private container registry lets you securely build and deploy your applications and custom code. Au cours de ce didacticiel, le deuxième d’une série de sept, vous allez déployer une instance ACR et lui envoyer une image conteneur par une transmission de type push.In this tutorial, part two of seven, you deploy an ACR instance and push a container image to it. Vous allez apprendre à effectuer les actions suivantes :You learn how to:

  • Créer une instance Azure Container Registry (ACR)Create an Azure Container Registry (ACR) instance
  • Marquer une image conteneur pour ACRTag a container image for ACR
  • Charger l’image dans ACRUpload the image to ACR
  • Visualiser les images figurant dans votre registreView images in your registry

Dans d’autres didacticiels, cette instance ACR est intégrée à un cluster Kubernetes dans AKS, et une application est déployée à partir de l’image.In additional tutorials, this ACR instance is integrated with a Kubernetes cluster in AKS, and an application is deployed from the image.

Avant de commencerBefore you begin

Dans le didacticiel précédent, une image conteneur a été créée pour une application Azure Vote.In the previous tutorial, a container image was created for a simple Azure Voting application. Si vous n’avez pas créé l’image de l’application Azure Vote, retournez au Didacticiel 1 : Créer des images conteneur.If you have not created the Azure Voting app image, return to Tutorial 1 – Create container images.

Ce didacticiel nécessite l’exécution de l’interface de ligne de commande Azure CLI version 2.0.53 ou ultérieure.This tutorial requires that you're running the Azure CLI version 2.0.53 or later. Exécutez az --version pour trouver la version.Run az --version to find the version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.If you need to install or upgrade, see Install Azure CLI.

Création d’un Azure Container RegistryCreate an Azure Container Registry

Pour créer une instance Azure Container Registry, vous devez tout d’abord disposer d’un groupe de ressources.To create an Azure Container Registry, you first need a resource group. Un groupe de ressources Azure est un conteneur logique dans lequel les ressources Azure sont déployées et gérées.An Azure resource group is a logical container into which Azure resources are deployed and managed.

Créez un groupe de ressources avec la commande az group create.Create a resource group with the az group create command. Dans l’exemple suivant, un groupe de ressources nommé myResourceGroup est créé dans la région eastus :In the following example, a resource group named myResourceGroup is created in the eastus region:

az group create --name myResourceGroup --location eastus

Créez une instance Azure Container Registry avec la commande az acr create et fournissez votre propre nom de registre.Create an Azure Container Registry instance with the az acr create command and provide your own registry name. Le nom du registre doit être unique dans Azure et contenir entre 5 et 50 caractères alphanumériques.The registry name must be unique within Azure, and contain 5-50 alphanumeric characters. Dans le reste de ce didacticiel, <acrName> est utilisé comme espace réservé pour le nom du registre de conteneurs.In the rest of this tutorial, <acrName> is used as a placeholder for the container registry name. Indiquez un nom de registre unique.Provide your own unique registry name. La référence SKU De base est un point d’entrée au coût optimisé fourni à des fins de développement qui offre un bon équilibre entre stockage et débit.The Basic SKU is a cost-optimized entry point for development purposes that provides a balance of storage and throughput.

az acr create --resource-group myResourceGroup --name <acrName> --sku Basic

Se connecter au registre de conteneursLog in to the container registry

Pour utiliser l’instance ACR, vous devez commencer par vous y connecter.To use the ACR instance, you must first log in. Utilisez la commande az acr login et fournissez le nom unique que vous avez attribué au registre de conteneurs à l’étape précédente.Use the az acr login command and provide the unique name given to the container registry in the previous step.

az acr login --name <acrName>

Après son exécution, la commande retourne le message Login Succeeded (Connexion réussie) .The command returns a Login Succeeded message once completed.

Baliser une image conteneurTag a container image

Pour afficher la liste des images locales actuelles, utilisez la commande docker images :To see a list of your current local images, use the docker images command:

$ docker images

REPOSITORY                   TAG                 IMAGE ID            CREATED             SIZE
azure-vote-front             latest              4675398c9172        13 minutes ago      694MB
redis                        latest              a1b99da73d05        7 days ago          106MB
tiangolo/uwsgi-nginx-flask   flask               788ca94b2313        9 months ago        694MB

Pour utiliser l’image conteneur azure-vote-front avec ACR, vous devez baliser cette image avec l’adresse du serveur de connexion de votre registre.To use the azure-vote-front container image with ACR, the image needs to be tagged with the login server address of your registry. Cette balise est utilisée pour l’acheminement lors de l’envoi des images de conteneur dans un registre d’images.This tag is used for routing when pushing container images to an image registry.

Pour obtenir l’adresse du serveur de connexion, utilisez la commande az acr list et exécutez une requête portant sur l’élément loginServer, comme suit :To get the login server address, use the az acr list command and query for the loginServer as follows:

az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table

À présent, étiquetez votre image azure-vote-front locale avec l’adresse acrLoginServer du registre de conteneurs.Now, tag your local azure-vote-front image with the acrLoginServer address of the container registry. Pour indiquer la version de l’image, ajoutez :v1 à la fin du nom de l’image :To indicate the image version, add :v1 to the end of the image name:

docker tag azure-vote-front <acrLoginServer>/azure-vote-front:v1

Pour vérifier que les étiquettes sont appliquées, réexécutez la commande docker images.To verify the tags are applied, run docker images again. Une image est balisée avec l’adresse de l’instance ACR et un numéro de version.An image is tagged with the ACR instance address and a version number.

$ docker images

REPOSITORY                                           TAG           IMAGE ID            CREATED             SIZE
azure-vote-front                                     latest        eaf2b9c57e5e        8 minutes ago       716 MB
mycontainerregistry.azurecr.io/azure-vote-front      v1            eaf2b9c57e5e        8 minutes ago       716 MB
redis                                                latest        a1b99da73d05        7 days ago          106MB
tiangolo/uwsgi-nginx-flask                           flask         788ca94b2313        8 months ago        694 MB

Envoyer des images au registrePush images to registry

Une fois votre image développée et balisée, envoyez l’image azure-vote-front à votre instance ACR.With your image built and tagged, push the azure-vote-front image to your ACR instance. Utilisez la commande docker push et fournissez votre propre adresse acrLoginServer pour le nom d’image, comme suit :Use docker push and provide your own acrLoginServer address for the image name as follows:

docker push <acrLoginServer>/azure-vote-front:v1

L’envoi de l’image à ACR peut nécessiter quelques minutes.It may take a few minutes to complete the image push to ACR.

Créer la liste des images du registreList images in registry

Pour retourner la liste des images qui ont été envoyées à votre instance ACR, utilisez la commande az acr repository list.To return a list of images that have been pushed to your ACR instance, use the az acr repository list command. Fournissez votre propre <acrName>, comme suit :Provide your own <acrName> as follows:

az acr repository list --name <acrName> --output table

L’exemple de sortie ci-après répertorie l’image azure-vote-front comme étant disponible dans le registre :The following example output lists the azure-vote-front image as available in the registry:

Result
----------------
azure-vote-front

Pour visualiser les étiquettes d’une image spécifique, utilisez la commande az acr repository show-tags comme suit :To see the tags for a specific image, use the az acr repository show-tags command as follows:

az acr repository show-tags --name <acrName> --repository azure-vote-front --output table

L’exemple de sortie ci-après présente l’image v1 balisée lors d’une étape précédente :The following example output shows the v1 image tagged in a previous step:

Result
--------
v1

Vous disposez désormais d’une image conteneur stockée dans une instance Azure Container Registry privée.You now have a container image that is stored in a private Azure Container Registry instance. Au cours du didacticiel suivant, cette image est déployée à partir d’ACR vers un cluster Kubernetes.This image is deployed from ACR to a Kubernetes cluster in the next tutorial.

Étapes suivantesNext steps

Dans le cadre de ce didacticiel, vous avez créé une instance Azure Container Registry et vous lui avez envoyé une image à utiliser dans un cluster AKS.In this tutorial, you created an Azure Container Registry and pushed an image for use in an AKS cluster. Vous avez appris à :You learned how to:

  • Créer une instance Azure Container Registry (ACR)Create an Azure Container Registry (ACR) instance
  • Marquer une image conteneur pour ACRTag a container image for ACR
  • Charger l’image dans ACRUpload the image to ACR
  • Visualiser les images figurant dans votre registreView images in your registry

Passez au didacticiel suivant pour découvrir comment déployer un cluster Kubernetes dans Azure.Advance to the next tutorial to learn how to deploy a Kubernetes cluster in Azure.