Démarrage rapide : Créer un registre de conteneurs privé à l’aide du portail AzureQuickstart: Create a private container registry using the Azure portal

Un registre de conteneurs Azure est un registre Docker privé dans Azure, où vous pouvez stocker et gérer des images de conteneurs Docker privés ainsi que les artefacts associés.An Azure container registry is a private Docker registry in Azure where you can store and manage private Docker container images and related artifacts. Dans ce guide de démarrage rapide, vous allez créer un registre de conteneurs à partir du portail Azure.In this quickstart, you create a container registry with the Azure portal. Vous allez ensuite utiliser des commandes Docker pour envoyer (push) une image conteneur dans le registre, puis tirer (pull) et exécuter l’image à partir de votre registre.Then, use Docker commands to push a container image into the registry, and finally pull and run the image from your registry.

Pour vous connecter au registre et utiliser des images conteneur, ce guide de démarrage rapide vous demande d’exécuter Azure CLI (version 2.0.55 ou ultérieure recommandée).To log in to the registry to work with container images, this quickstart requires that you are running the Azure CLI (version 2.0.55 or later recommended). 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.

Docker doit également être installé en local.You must also have Docker installed locally. Docker fournit des packages qui le configurent facilement sur n’importe quel système Mac, Windows ou Linux.Docker provides packages that easily configure Docker on any Mac, Windows, or Linux system.

Connexion à AzureSign in to Azure

Connectez-vous au portail Azure sur https://portal.azure.com.Sign in to the Azure portal at https://portal.azure.com.

Créer un registre de conteneurCreate a container registry

Sélectionnez Créer une ressource > Conteneurs > Container Registry.Select Create a resource > Containers > Container Registry.

Création d’un registre de conteneur dans le portail Azure

Sous l’onglet Informations de base, entrez les valeurs appropriées pour Groupe de ressources et Nom du registre.In the Basics tab, enter values for Resource group and 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. Pour ce guide de démarrage rapide, créez un groupe de ressources dans l’emplacement West US nommé myResourceGroup, et sélectionnez « De base » pour SKU.For this quickstart create a new resource group in the West US location named myResourceGroup, and for SKU, select 'Basic'.

Créer un registre de conteneurs dans le portail Azure

Acceptez les valeurs par défaut pour les autres paramètres.Accept default values for the remaining settings. Sélectionnez ensuite Passer en revue + créer .Then select Review + create. Après avoir passé en revue les paramètres, sélectionnez Créer.After reviewing the settings, select Create.

Dans ce guide de démarrage rapide, vous allez créer un registreDe base. Il s’agit d’une option à coût optimisé pour les développeurs qui apprennent à se servir d’Azure Container Registry.In this quickstart you create a Basic registry, which is a cost-optimized option for developers learning about Azure Container Registry. Pour plus d’informations sur les niveaux de service disponibles, consultez Références SKU des registres de conteneurs.For details on available service tiers, see Container registry SKUs.

Quand le message Déploiement réussi s’affiche, sélectionnez le registre de conteneurs dans le portail.When the Deployment succeeded message appears, select the container registry in the portal.

Vue d’ensemble du registre de conteneurs dans le portail Azure

Notez la valeur du Serveur de connexion.Take note of the value of the Login server. Vous utilisez cette valeur dans les étapes suivantes quand vous effectuez l’envoi (push) et le tirage (pull) d’images avec Docker.You use this value in the following steps when you push and pull images with Docker.

Se connecter au registreLog in to registry

Avant d’extraire et de transmettre des images conteneur, vous devez vous connecter à l’instance ACR.Before pushing and pulling container images, you must log in to the ACR instance. Ouvrez un interpréteur de commandes dans votre système d’exploitation, puis utilisez la commande az acr login dans Azure CLI.Open a command shell in your operating system, and use the az acr login command in the Azure CLI. (Spécifiez uniquement le nom du registre au moment de la connexion.(Specify only the registry name when logging in. N’incluez pas le suffixe « azurecr.io ».)Don't include the 'azurecr.io' suffix.)

az acr login --name <acrName>

Une fois l’opération terminée, la commande renvoie Login Succeeded.The command returns Login Succeeded once completed.

Envoyer l’image au registrePush image to registry

Pour envoyer une image dans un registre Azure Container Registry, vous devez tout d’abord disposer d’une image.To push an image to an Azure Container registry, you must first have an image. Si vous n’avez pas encore d’images conteneur locales, exécutez la commande docker pull suivante pour extraire (pull) une image existante du Docker Hub.If you don't yet have any local container images, run the following docker pull command to pull an existing image from Docker Hub. Pour cet exemple, tirez l’image hello-world.For this example, pull the hello-world image.

docker pull hello-world

Avant de pousser (push) une image vers le registre, vous devez la marquer avec le nom complet de votre serveur de connexion ACR.Before you can push an image to your registry, you must tag it with the fully qualified name of your ACR login server. Le nom du serveur de connexion est au format <nom-registre>.azurecr.io (tout en minuscules). Par exemple : mycontainerregistry007.azurecr.io.The login server name is in the format <registry-name>.azurecr.io (all lowercase), for example, mycontainerregistry007.azurecr.io.

Étiquetez l’image en utilisant la commande docker tag.Tag the image using the docker tag command. Remplacez <acrLoginServer> par le nom du serveur de connexion de votre instance ACR.Replace <acrLoginServer> with the login server name of your ACR instance.

docker tag hello-world <acrLoginServer>/hello-world:v1

Enfin, utilisez la commande docker push pour envoyer l’image à l’instance ACR.Finally, use docker push to push the image to the ACR instance. Remplacez <acrLoginServer> par le nom du serveur de connexion de votre instance ACR.Replace <acrLoginServer> with the login server name of your ACR instance. Cet exemple crée le référentiel hello-world qui contient l’image hello-world:v1.This example creates the hello-world repository, containing the hello-world:v1 image.

docker push <acrLoginServer>/hello-world:v1

Après avoir envoyé (push) l’image à votre registre de conteneurs, supprimez l’image hello-world:v1 de votre environnement Docker local.After pushing the image to your container registry, remove the hello-world:v1 image from your local Docker environment. (Notez que cette commande docker rmi ne supprime pas l’image du référentiel hello-world dans votre registre de conteneurs Azure.)(Note that this docker rmi command does not remove the image from the hello-world repository in your Azure container registry.)

docker rmi <acrLoginServer>/hello-world:v1

Répertorier les images conteneurList container images

Pour lister les images de votre registre, accédez à ce dernier dans le portail, puis sélectionnez Référentiels et le référentiel que vous avez créé avec docker push.To list the images in your registry, navigate to your registry in the portal and select Repositories, then select the repository you created with docker push.

Dans cet exemple, nous sélectionnons le dépôt hello-world, et nous voyons l’image étiquetée v1 sous Étiquettes.In this example, we select the hello-world repository, and we can see the v1-tagged image under Tags.

Lister les images conteneur dans le portail Azure

Exécuter l’image à partir du registreRun image from registry

Vous pouvez à présent extraire (pull) et exécuter l’image conteneur hello-world:v1 à partir de votre registre de conteneurs à l’aide de docker run :Now, you can pull and run the hello-world:v1 container image from your container registry by using docker run:

docker run <acrLoginServer>/hello-world:v1  

Exemple de sortie :Example output:

Unable to find image 'mycontainerregistry007.azurecr.io/hello-world:v1' locally
v1: Pulling from hello-world
Digest: sha256:662dd8e65ef7ccf13f417962c2f77567d3b132f12c95909de6c85ac3c326a345
Status: Downloaded newer image for mycontainerregistry007.azurecr.io/hello-world:v1

Hello from Docker!
This message shows that your installation appears to be working correctly.

[...]

Nettoyer les ressourcesClean up resources

Pour supprimer vos ressources, accédez au groupe de ressources myResourceGroup dans le portail.To clean up your resources, navigate to the myResourceGroup resource group in the portal. Une fois le groupe de ressources chargé, cliquez sur Supprimer le groupe de ressources pour supprimer le groupe de ressources, le registre de conteneurs et les images conteneur stockées à cet endroit.Once the resource group is loaded click on Delete resource group to remove the resource group, the container registry, and the container images stored there.

Supprimer un groupe de ressources dans le portail Azure

Étapes suivantesNext steps

Dans ce guide de démarrage rapide, vous avez créé un registre de conteneurs Azure avec le portail Azure, envoyé (push) une image conteneur, puis tiré (pull) et exécuté l’image à partir du registre.In this quickstart, you created an Azure Container Registry with the Azure portal, pushed a container image, and pulled and ran the image from the registry. Passez à présent au tutoriel sur Azure Container Registry (ACR) pour approfondir vos connaissances.Continue to the Azure Container Registry tutorials for a deeper look at ACR.