Zelfstudie: Azure Container Registry implementeren en gebruikenTutorial: Deploy and use Azure Container Registry

Azure Container Registry (ACR) is een privéregister voor installatiekopieën van de container.Azure Container Registry (ACR) is a private registry for container images. Een particulier containerregister stelt u in staat om op een veilige manier toepassingen en aangepaste code te bouwen en implementeren.A private container registry lets you securely build and deploy your applications and custom code. In deze zelfstudie, deel twee van zeven, implementeert u een ACR-exemplaar en pusht u vervolgens een containerinstallatiekopie naar het exemplaar.In this tutorial, part two of seven, you deploy an ACR instance and push a container image to it. In deze zelfstudie leert u procedures om het volgende te doen:You learn how to:

  • Een ACR-exemplaar (Azure Container Registry) makenCreate an Azure Container Registry (ACR) instance
  • Een containerinstallatiekopie voor ACR taggenTag a container image for ACR
  • De installatiekopie uploaden naar ACRUpload the image to ACR
  • Installatiekopieën weergeven in het registerView images in your registry

In aanvullende zelfstudies wordt dit ACR-exemplaar geïntegreerd met een Kubernetes-cluster in AKS en wordt er met behulp van de installatiekopie een toepassing geïmplementeerd.In additional tutorials, this ACR instance is integrated with a Kubernetes cluster in AKS, and an application is deployed from the image.

Voordat u begintBefore you begin

In de vorige zelfstudie hebt u een containerinstallatiekopie voor een eenvoudige Azure Voting-toepassing gemaakt.In the previous tutorial, a container image was created for a simple Azure Voting application. Als u de installatiekopie voor de Azure Voting-toepassing niet hebt gemaakt, ga dan terug naar Zelfstudie 1: Containerinstallatiekopieën maken.If you have not created the Azure Voting app image, return to Tutorial 1 – Create container images.

Voor deze zelfstudie moet u Azure CLI versie 2.0.53 of hoger uitvoeren.This tutorial requires that you're running the Azure CLI version 2.0.53 or later. Voer az --version uit om de versie te bekijken.Run az --version to find the version. Zie Azure CLI installeren als u de CLI wilt installeren of een upgrade wilt uitvoeren.If you need to install or upgrade, see Install Azure CLI.

Een Azure Container Registry makenCreate an Azure Container Registry

Om een Azure-containerregister te maken, hebt u eerst een resourcegroep nodig.To create an Azure Container Registry, you first need a resource group. Een Azure-resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd.An Azure resource group is a logical container into which Azure resources are deployed and managed.

Een resourcegroep maken met de opdracht az group create.Create a resource group with the az group create command. In het volgende voorbeeld wordt een resourcegroep met de naam myResourceGroup gemaakt in de regio eastus:In the following example, a resource group named myResourceGroup is created in the eastus region:

az group create --name myResourceGroup --location eastus

Maak een Azure Container Registry-exemplaar met de opdracht az acr create en geef de naam van uw register op.Create an Azure Container Registry instance with the az acr create command and provide your own registry name. De registernaam moet uniek zijn binnen Azure en mag 5 tot 50 alfanumerieke tekens bevatten.The registry name must be unique within Azure, and contain 5-50 alphanumeric characters. In de rest van deze zelfstudie wordt <acrName> gebruikt als een tijdelijke aanduiding voor de naam van het containerregister.In the rest of this tutorial, <acrName> is used as a placeholder for the container registry name. Geef een unieke naam voor uw register op.Provide your own unique registry name. De SKU Basic is een toegangspunt voor ontwikkelingsdoeleinden dat is geoptimaliseerd voor kosten, met een balans tussen opslag en doorvoer.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

Aanmelden bij het containerregisterLog in to the container registry

Als u het ACR-exemplaar wilt gebruiken, moet u zich eerst aanmelden.To use the ACR instance, you must first log in. Gebruik de opdracht az acr login en voer de unieke naam in die u in de vorige stap aan het containerregister hebt gegeven.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>

De opdracht retourneert het bericht Aanmelden geslaagd wanneer deze is uitgevoerd.The command returns a Login Succeeded message once completed.

Een containerinstallatiekopie taggenTag a container image

Als u een lijst met de huidige installatiekopieën wilt weergeven, gebruikt u de opdracht docker images:To see a list of your current local images, use the docker images command:

$ docker images

Met de bovenstaande opdrachtuitvoer wordt een lijst van uw huidige lokale afbeeldingen weergegeven:The above command output shows list of your current local 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

Als u de containerinstallatiekopie azure-vote-front wilt gebruiken met ACR, moet de installatiekopie worden getagd met het adres van de aanmeldingsserver van uw register.To use the azure-vote-front container image with ACR, the image needs to be tagged with the login server address of your registry. Deze tag wordt gebruikt voor routering bij het pushen van containerinstallatiekopieën naar een installatiekopieregister.This tag is used for routing when pushing container images to an image registry.

U kunt het adres van de aanmeldingsserver opvragen door met de opdracht az acr list als volgt een query uit te voeren op de loginServer: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

Tag nu de lokale installatiekopie azure-vote-front met het adres acrloginServer van het containerregister.Now, tag your local azure-vote-front image with the acrLoginServer address of the container registry. U kunt de versie van de installatiekopie aangeven door :v1 toe te voegen aan het eind van de naam van de installatiekopie:To indicate the image version, add :v1 to the end of the image name:

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

Controleer of de tags zijn toegepast door docker images opnieuw uit te voeren.To verify the tags are applied, run docker images again.

$ docker images

Een installatiekopie wordt getagd met het adres van het ACR-exemplaar en een versienummer.An image is tagged with the ACR instance address and a version number.

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

Installatiekopieën naar het register pushenPush images to registry

U kunt de gemaakte en getagde installatiekopie azure-vote-front nu pushen naar het ACR-exemplaar.With your image built and tagged, push the azure-vote-front image to your ACR instance. Gebruik docker push en geef als volgt uw eigen acrLoginServer-adres op voor de naam van de installatiekopie:Use docker push and provide your own acrLoginServer address for the image name as follows:

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

Het kan enkele minuten duren voordat de installatiekopie naar ACR is gepusht.It may take a few minutes to complete the image push to ACR.

Installatiekopieën vermelden in het registerList images in registry

Gebruik de opdracht az acr repository list om een lijst weer te geven met installatiekopieën die naar het ACR-exemplaar zijn gepusht.To return a list of images that have been pushed to your ACR instance, use the az acr repository list command. Geef als volgt uw eigen <acrName> op:Provide your own <acrName> as follows:

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

In het volgende voorbeeld van uitvoer ziet u dat de installatiekopie azure-vote-front beschikbaar is in het register:The following example output lists the azure-vote-front image as available in the registry:

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

Gebruik de opdracht az acr repository show-tags als volgt om de tags voor een specifieke installatiekopie te zien: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

In het volgende voorbeeld van uitvoer ziet u de tag v1 zoals toegevoegd aan de installatiekopie in een eerdere stap:The following example output shows the v1 image tagged in a previous step:

Result
--------
v1

U beschikt nu over een containerinstallatiekopie die is opgeslagen in een particulier Azure Container Registry-exemplaar.You now have a container image that is stored in a private Azure Container Registry instance. Deze installatiekopie wordt in de volgende zelfstudie vanuit ACR geïmplementeerd naar een Kubernetes-cluster.This image is deployed from ACR to a Kubernetes cluster in the next tutorial.

Volgende stappenNext steps

In deze zelfstudie hebt u een Azure Container Registry gemaakt en een installatiekopie gepusht voor gebruik in een AKS-cluster.In this tutorial, you created an Azure Container Registry and pushed an image for use in an AKS cluster. U hebt geleerd hoe u:You learned how to:

  • Een ACR-exemplaar (Azure Container Registry) makenCreate an Azure Container Registry (ACR) instance
  • Een containerinstallatiekopie voor ACR taggenTag a container image for ACR
  • De installatiekopie uploaden naar ACRUpload the image to ACR
  • Installatiekopieën weergeven in het registerView images in your registry

Ga naar de volgende zelfstudie voor informatie over het implementeren van een Kubernetes-cluster in Azure.Advance to the next tutorial to learn how to deploy a Kubernetes cluster in Azure.