Tutorial: Bereitstellen und Verwenden von Azure Container RegistryTutorial: Deploy and use Azure Container Registry

Bei Azure Container Registry (ACR) handelt es sich um eine private Registrierung für Containerimages.Azure Container Registry (ACR) is a private registry for container images. Mit einer privaten Containerregistrierung können Sie Ihre Anwendungen und benutzerdefinierten Code auf sichere Weise erstellen und bereitstellen.A private container registry lets you securely build and deploy your applications and custom code. In diesem Tutorial – Teil 2 von 7 – stellen Sie eine ACR-Instanz bereit und übertragen mithilfe von Push ein Containerimage an diese.In this tutorial, part two of seven, you deploy an ACR instance and push a container image to it. Folgendes wird vermittelt:You learn how to:

  • Erstellen einer Azure Container Registry-Instanz (ACR)Create an Azure Container Registry (ACR) instance
  • Kennzeichnen eines Containerimages für ACRTag a container image for ACR
  • Hochladen des Images in die ACR-InstanzUpload the image to ACR
  • Anzeigen von Images in der RegistrierungView images in your registry

In den nachfolgenden Tutorials wird diese ACR-Instanz in einen Kubernetes-Cluster in AKS integriert, und eine Anwendung wird anhand des Images bereitgestellt.In additional tutorials, this ACR instance is integrated with a Kubernetes cluster in AKS, and an application is deployed from the image.

VoraussetzungenBefore you begin

Im vorherigen Tutorial wurde ein Containerimage für eine einfache Azure Voting-App erstellt.In the previous tutorial, a container image was created for a simple Azure Voting application. Wenn Sie das Image der Azure Voting-App noch nicht erstellt haben, kehren Sie zum Tutorial 1 – Erstellen von Containerimages zurück.If you have not created the Azure Voting app image, return to Tutorial 1 – Create container images.

Für dieses Tutorial müssen Sie mindestens Version 2.0.53 der Azure CLI ausführen.This tutorial requires that you're running the Azure CLI version 2.0.53 or later. Führen Sie az --version aus, um die Version zu finden.Run az --version to find the version. Informationen zum Durchführen einer Installation oder eines Upgrades finden Sei bei Bedarf unter Installieren der Azure CLI.If you need to install or upgrade, see Install Azure CLI.

Erstellen einer Azure-ContainerregistrierungCreate an Azure Container Registry

Zum Erstellen einer Azure Container Registry-Instanz benötigen Sie zunächst eine Ressourcengruppe.To create an Azure Container Registry, you first need a resource group. Eine Azure-Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen bereitgestellt und verwaltet werden.An Azure resource group is a logical container into which Azure resources are deployed and managed.

Erstellen Sie mit dem Befehl az group create eine Ressourcengruppe.Create a resource group with the az group create command. Im folgenden Beispiel wird eine Ressourcengruppe mit dem Namen myResourceGroup in der Region eastus erstellt:In the following example, a resource group named myResourceGroup is created in the eastus region:

az group create --name myResourceGroup --location eastus

Erstellen Sie mit dem Befehl az acr create eine Azure Container Registry-Instanz, und geben Sie einen eigenen Registrierungsnamen an.Create an Azure Container Registry instance with the az acr create command and provide your own registry name. Der Registrierungsname muss innerhalb von Azure eindeutig sein und zwischen 5 und 50 alphanumerische Zeichen enthalten.The registry name must be unique within Azure, and contain 5-50 alphanumeric characters. Im weiteren Verlauf dieses Tutorials wird <acrName> als Platzhalter für den Namen der Containerregistrierung verwendet.In the rest of this tutorial, <acrName> is used as a placeholder for the container registry name. Geben Sie Ihren eigenen eindeutigen Registrierungsnamen an.Provide your own unique registry name. Die Basic-SKU ist ein kostenoptimierter Einstiegspunkt für Entwicklungszwecke, der ein ausgewogenes Verhältnis von Speicher und Durchsatz bietet.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

Anmelden bei der ContainerregistrierungLog in to the container registry

Zur Verwendung der ACR-Instanz müssen Sie sich zunächst anmelden.To use the ACR instance, you must first log in. Führen Sie den Befehl az acr login aus, und geben Sie den eindeutigen Namen der Containerregistrierung aus dem vorherigen Schritt an.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>

Nach Abschluss des Vorgangs wird eine Erfolgsmeldung zurückgegeben.The command returns a Login Succeeded message once completed.

Markieren eines ContainerimagesTag a container image

Verwenden Sie den Befehl docker images, um eine Liste Ihrer aktuellen lokalen Images anzuzeigen: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

Zur Verwendung des Containerimages azure-vote-front mit ACR muss das Image mit der Anmeldeserveradresse Ihrer Registrierung markiert werden.To use the azure-vote-front container image with ACR, the image needs to be tagged with the login server address of your registry. Dieses Tag wird beim Übertragen von Containerimages per Push in eine Imageregistrierung für das Routing verwendet.This tag is used for routing when pushing container images to an image registry.

Führen Sie den Befehl az acr list aus, um die Anmeldeserveradresse abzurufen, und fragen Sie loginServer wie folgt ab: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

Markieren Sie jetzt Ihr lokales Image azure-vote-front mit der acrloginServer-Adresse der Containerregistrierung.Now, tag your local azure-vote-front image with the acrloginServer address of the container registry. Fügen Sie am Ende des Imagenamens :v1 hinzu, um die Imageversion anzugeben:To indicate the image version, add :v1 to the end of the image name:

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

Führen Sie docker images erneut aus, um sich zu vergewissern, dass die Tags angewendet wurden.To verify the tags are applied, run docker images again. Ein Image ist mit der Adresse der ACR-Instanz und einer Versionsnummer markiert.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

Übertragen von Images in die Registrierung per PushPush images to registry

Nachdem das Image erstellt und markiert wurde, können Sie das Image azure-vote-front per Push an Ihre ACR-Instanz übertragen.With your image built and tagged, push the azure-vote-front image to your ACR instance. Verwenden Sie docker push, und geben Sie Ihre eigene acrLoginServer-Adresse wie folgt als Imagename an:Use docker push and provide your own acrLoginServer address for the image name as follows:

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

Die Pushübertragung des Images an ACR kann einige Minuten dauern.It may take a few minutes to complete the image push to ACR.

Auflisten von Images in der RegistrierungList images in registry

Führen Sie den Befehl az acr repository list aus, um eine Liste der Images zurückzugeben, die an Ihre ACR-Instanz gepusht wurden.To return a list of images that have been pushed to your ACR instance, use the az acr repository list command. Geben Sie Ihren eigenen <acrName>-Wert wie folgt an:Provide your own <acrName> as follows:

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

Die folgende Beispielausgabe listet das Image azure-vote-front in der Registrierung als verfügbar auf:The following example output lists the azure-vote-front image as available in the registry:

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

Verwenden Sie den Befehl az acr repository show-tags wie folgt, um die Tags für ein bestimmtes Image anzuzeigen: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

Die folgende Beispielausgabe zeigt das in einem vorherigen Schritt markierte v1-Image:The following example output shows the v1 image tagged in a previous step:

Result
--------
v1

Sie verfügen jetzt über ein Containerimage, das in einer privaten Azure Container Registry-Instanz gespeichert ist.You now have a container image that is stored in a private Azure Container Registry instance. Dieses Image wird im nächsten Tutorial aus ACR in einem Kubernetes-Cluster bereitgestellt.This image is deployed from ACR to a Kubernetes cluster in the next tutorial.

Nächste SchritteNext steps

In diesem Tutorial haben Sie eine Azure Container Registry-Instanz erstellt und ein Image per Push für die Verwendung in einem AKS-Cluster übertragen.In this tutorial, you created an Azure Container Registry and pushed an image for use in an AKS cluster. Es wurde Folgendes vermittelt:You learned how to:

  • Erstellen einer Azure Container Registry-Instanz (ACR)Create an Azure Container Registry (ACR) instance
  • Kennzeichnen eines Containerimages für ACRTag a container image for ACR
  • Hochladen des Images in die ACR-InstanzUpload the image to ACR
  • Anzeigen von Images in der RegistrierungView images in your registry

Im nächsten Tutorial erfahren Sie, wie Sie einen Kubernetes-Cluster in Azure bereitstellen.Advance to the next tutorial to learn how to deploy a Kubernetes cluster in Azure.