Uw eerste installatiekopie naar een Docker-containerregister pushen met de Docker-CLIPush your first image to a private Docker container registry using the Docker CLI

Een Azure-containerregister slaat persoonlijke Docker-containerinstallatiekopieën op en beheert ze, vergelijkbaar met de manier waarop Docker Hub openbare Docker-installatiekopieën opslaat.An Azure container registry stores and manages private Docker container images, similar to the way Docker Hub stores public Docker images. U kunt de docker-opdracht regel interface (docker CLI) gebruiken voor aanmelding, Push, pullen andere bewerkingen in het container register.You can use the Docker command-line interface (Docker CLI) for login, push, pull, and other operations on your container registry.

In de volgende stappen downloadt u een officiële nginx-installatie kopie uit het open bare docker hub-REGI ster, labelt u deze voor uw persoonlijke Azure-container register, pusht u deze naar uw REGI ster en haalt u het vervolgens op uit het REGI ster.In the following steps, you download an official Nginx image from the public Docker Hub registry, tag it for your private Azure container registry, push it to your registry, and then pull it from the registry.

VereistenPrerequisites

  • Azure-containerregister: maak een containerregister in uw Azure-abonnement.Azure container registry - Create a container registry in your Azure subscription. Gebruik bijvoorbeeld de Azure Portal of de Azure cli.For example, use the Azure portal or the Azure CLI.
  • Docker cli : u moet ook docker lokaal hebben geïnstalleerd.Docker CLI - You must also have Docker installed locally. Docker biedt pakketten waarmee docker eenvoudig kan worden geconfigureerd op een macOS, Windows-of [Linux][docker-Linux-] systeem.Docker provides packages that easily configure Docker on any macOS, Windows, or Linux system.

Aanmelden bij een registerLog in to a registry

Er zijn verschillende manieren om te verifiëren bij uw persoonlijke container register.There are several ways to authenticate to your private container registry. De aanbevolen methode voor het werken op een opdracht regel is met de Azure CLI-opdracht AZ ACR login.The recommended method when working in a command line is with the Azure CLI command az acr login. Als u zich bijvoorbeeld wilt aanmelden bij een REGI ster met de naam myregistry:For example, to log in to a registry named myregistry:

az acr login --name myregistry

U kunt zich ook aanmelden met docker-aanmelding.You can also log in with docker login. Stel dat u een Service-Principal hebt toegewezen aan het REGI ster voor een automatiserings scenario.For example, you might have assigned a service principal to your registry for an automation scenario. Wanneer u de volgende opdracht uitvoert, geeft u de Service-Principal appID (gebruikers naam) en het wacht woord interactief op wanneer u hierom wordt gevraagd.When you run the following command, interactively provide the service principal appID (username) and password when prompted. Zie voor aanbevolen procedures voor het beheren van aanmeldings referenties de opdracht referentie voor docker- aanmelding :For best practices to manage login credentials, see the docker login command reference:

docker login myregistry.azurecr.io

Beide opdrachten retour Login Succeeded neren eenmaal voltooid.Both commands return Login Succeeded once completed.

Tip

Geef altijd de volledig gekwalificeerde register naam op (alle kleine letters) wanneer docker login u gebruikt en wanneer u afbeeldingen labelt voor het naar uw REGI ster pushen.Always specify the fully qualified registry name (all lowercase) when you use docker login and when you tag images for pushing to your registry. In de voor beelden in dit artikel is de volledig gekwalificeerde naam myregistry.azurecr.io.In the examples in this article, the fully qualified name is myregistry.azurecr.io.

De officiële nginx-installatie kopie ophalenPull the official Nginx image

Haal eerst de open bare nginx-installatie kopie op uw lokale computer.First, pull the public Nginx image to your local computer.

docker pull nginx

De container lokaal uitvoerenRun the container locally

Voer de volgende opdracht docker run uit om een lokaal exemplaar van de nginx-container interactief te-itstarten () op poort 8080.Execute following docker run command to start a local instance of the Nginx container interactively (-it) on port 8080. Het --rm argument geeft aan dat de container moet worden verwijderd wanneer u deze stopt.The --rm argument specifies that the container should be removed when you stop it.

docker run -it --rm -p 8080:80 nginx

Blader naar http://localhost:8080 om de standaard webpagina weer te geven die wordt aangeboden door nginx in de container die wordt uitgevoerd.Browse to http://localhost:8080 to view the default web page served by Nginx in the running container. Er wordt een pagina weer gegeven die er ongeveer als volgt uitziet:You should see a page similar to the following:

Nginx op lokale computer

Omdat u de container interactief met -ithebt gestart, ziet u de uitvoer van de nginx-server op de opdracht regel nadat u deze in uw browser hebt genavigeerd.Because you started the container interactively with -it, you can see the Nginx server's output on the command line after navigating to it in your browser.

Als u de container wilt stoppen en verwijderen Control, drukt u op + C.To stop and remove the container, press Control+C.

Een alias van de installatie kopie makenCreate an alias of the image

Gebruik docker tag om een alias van de installatie kopie te maken met het volledig gekwalificeerde pad naar uw REGI ster.Use docker tag to create an alias of the image with the fully qualified path to your registry. In dit voorbeeld wordt de naamruimte samples gespecificeerd om overbodige items in de hoofdmap van het register te voorkomen.This example specifies the samples namespace to avoid clutter in the root of the registry.

docker tag nginx myregistry.azurecr.io/samples/nginx

Zie de sectie naam ruimten van opslag plaatsen in aanbevolen procedures voor Azure container Registryvoor meer informatie over het labelen met naam ruimten.For more information about tagging with namespaces, see the Repository namespaces section of Best practices for Azure Container Registry.

De installatie kopie naar het REGI ster pushenPush the image to your registry

Nu u de installatie kopie hebt gelabeld met het volledig gekwalificeerde pad naar uw persoonlijke REGI ster, kunt u deze naar het REGI ster pushen met docker push:Now that you've tagged the image with the fully qualified path to your private registry, you can push it to the registry with docker push:

docker push myregistry.azurecr.io/samples/nginx

De installatie kopie uit het REGI ster halenPull the image from your registry

Gebruik de opdracht docker pull om de installatie kopie uit het REGI ster te halen:Use the docker pull command to pull the image from your registry:

docker pull myregistry.azurecr.io/samples/nginx

De nginx-container startenStart the Nginx container

Gebruik de opdracht docker run voor het uitvoeren van de installatie kopie die u uit het REGI ster hebt opgehaald:Use the docker run command to run the image you've pulled from your registry:

docker run -it --rm -p 8080:80 myregistry.azurecr.io/samples/nginx

Blader naar http://localhost:8080 om de actieve container weer te geven.Browse to http://localhost:8080 to view the running container.

Als u de container wilt stoppen en verwijderen Control, drukt u op + C.To stop and remove the container, press Control+C.

De installatie kopie verwijderen (optioneel)Remove the image (optional)

Als u de nginx-installatie kopie niet meer nodig hebt, kunt u deze lokaal verwijderen met de opdracht docker RMI .If you no longer need the Nginx image, you can delete it locally with the docker rmi command.

docker rmi myregistry.azurecr.io/samples/nginx

Als u installatie kopieën uit het Azure container Registry wilt verwijderen, kunt u de Azure CLI-opdracht AZ ACR repository deletegebruiken.To remove images from your Azure container registry, you can use the Azure CLI command az acr repository delete. Met de volgende opdracht wordt bijvoorbeeld het manifest verwijderd waarnaar wordt verwezen door samples/nginx:latest de tag, alle unieke laag gegevens en alle andere tags die verwijzen naar het manifest.For example, the following command deletes the manifest referenced by the samples/nginx:latest tag, any unique layer data, and all other tags referencing the manifest.

az acr repository delete --name myregistry --image samples/nginx:latest

Volgende stappenNext steps

Nu u de basis principes kent, bent u klaar om uw REGI ster te gaan gebruiken.Now that you know the basics, you're ready to start using your registry! Implementeer bijvoorbeeld container installatie kopieën uit het REGI ster naar:For example, deploy container images from your registry to:

Installeer eventueel de docker- extensie voor Visual Studio code en de Azure-account extensie om met uw Azure-container registers te werken.Optionally install the Docker Extension for Visual Studio Code and the Azure Account extension to work with your Azure container registries. Pull-en push-installatie kopieën naar een Azure container Registry, of voer ACR-taken uit, allemaal in Visual Studio code.Pull and push images to an Azure container registry, or run ACR Tasks, all within Visual Studio Code.