Schnellstart: Erstellen einer Azure-Containerregistrierung über das Azure-PortalQuickstart: Create an Azure container registry using the Azure portal

Eine Azure Container Registry-Instanz ist eine private Docker-Registrierung in Azure, in der Sie private Docker-Containerimages und zugehörige Artefakte speichern und verwalten können.An Azure container registry is a private Docker registry in Azure where you can store and manage private Docker container images and related artifacts. In dieser Schnellstartanleitung erstellen Sie eine Containerregistrierung über das Azure-Portal.In this quickstart, you create a container registry with the Azure portal. Übertragen Sie anschließend mithilfe von Docker-Befehlen ein Containerimage per Push in die Registrierung. Rufen Sie abschließend das Image per Pull aus der Registrierung ab, und führen Sie es aus.Then, use Docker commands to push a container image into the registry, and finally pull and run the image from your registry.

Für diese Schnellstartanleitung müssen Sie die Azure CLI (mindestens Version 2.0.55 empfohlen) ausführen, um sich bei der Registrierung anmelden und Containerimages verwenden zu können.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). Führen Sie az --version aus, um die Version zu ermitteln.Run az --version to find the version. Informationen zum Durchführen einer Installation oder eines Upgrades finden Sie bei Bedarf unter Installieren der Azure CLI.If you need to install or upgrade, see Install Azure CLI.

Darüber hinaus muss Docker lokal installiert sein.You must also have Docker installed locally. Für Docker sind Pakete erhältlich, mit denen Docker problemlos auf einem Mac-, Windows- oder Linux-System konfiguriert werden kann.Docker provides packages that easily configure Docker on any Mac, Windows, or Linux system.

Anmelden bei AzureSign in to Azure

Melden Sie sich unter https://portal.azure.com beim Azure-Portal an.Sign in to the Azure portal at https://portal.azure.com.

Erstellen einer ContainerregistrierungCreate a container registry

Klicken Sie auf Ressource erstellen > Container > Container Registry.Select Create a resource > Containers > Container Registry.

Navigieren zur Containerregistrierung im Portal

Geben Sie auf der Registerkarte Grundlagen Werte für Ressourcengruppe und Registrierungsname ein.In the Basics tab, enter values for Resource group and 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. Erstellen Sie im Rahmen dieser Schnellstartanleitung eine neue Ressourcengruppe namens myResourceGroup am Standort West US, und wählen Sie für SKU die Option „Basic“ aus.For this quickstart create a new resource group in the West US location named myResourceGroup, and for SKU, select 'Basic'.

Erstellen einer Containerregistrierung im Portal

Übernehmen Sie für die übrigen Einstellungen die Standardwerte.Accept default values for the remaining settings. Wählen Sie dann Überprüfen + erstellen aus.Then select Review + create. Überprüfen Sie die Einstellungen, und wählen Sie anschließend Erstellen aus.After reviewing the settings, select Create.

In dieser Schnellstartanleitung erstellen Sie eine Registrierung vom Typ Basic. Dabei handelt es sich um eine kostenoptimierte Option für Entwickler, die sich mit Azure Container Registry vertraut machen.In this quickstart you create a Basic registry, which is a cost-optimized option for developers learning about Azure Container Registry. Ausführliche Informationen zu verfügbaren Dienstebenen (SKUs) finden Sie unter Azure Container Registry-Tarife.For details on available service tiers (SKUs), see Container registry service tiers.

Wenn die Meldung Bereitstellung erfolgreich erscheint, wählen Sie die Containerregistrierung im Portal aus.When the Deployment succeeded message appears, select the container registry in the portal.

Containerregistrierungsübersicht im Portal

Notieren Sie sich den Registrierungsnamen und den Wert unter Anmeldeserver.Take note of the registry name and the value of the Login server. Sie verwenden diese Werte in den folgenden Schritten bei den Push- und Pullvorgängen für Images mit Docker.You use these values in the following steps when you push and pull images with Docker.

Anmelden bei der RegistrierungLog in to registry

Bevor Sie Push- und Pullvorgänge für Containerimages ausführen können, müssen Sie sich bei der Registrierungsinstanz anmelden.Before pushing and pulling container images, you must log in to the registry instance. Melden Sie sich auf dem lokalen Computer bei der Azure CLI an, und führen Sie dann den Befehl az acr login aus.Sign into the Azure CLI on your local machine, then run the az acr login command. Geben Sie beim Anmelden bei der Azure CLI nur den Registrierungsnamen an.Specify only the registry name when logging in with the Azure CLI. Verwenden Sie nicht den Namen des Anmeldeservers, der ein Domänensuffix wie azurecr.ioenthält.Don't use the login server name, which includes a domain suffix like azurecr.io.

az acr login --name <registry-name>

Beispiel:Example:

az acr login --name mycontainerregistry

Der Befehl gibt nach Abschluss des Vorgangs Login Succeeded zurück.The command returns Login Succeeded once completed.

Pushen eines Image in die RegistrierungPush image to registry

Um ein Image mithilfe von Push an Ihre Azure Container Registry-Instanz übertragen zu können, benötigen Sie zunächst ein Image.To push an image to an Azure Container registry, you must first have an image. Wenn Sie noch nicht über lokale Containerimages verfügen, führen Sie den folgenden docker pull-Befehl aus, um ein vorhandenes Image aus Docker Hub abzurufen.If you don't yet have any local container images, run the following docker pull command to pull an existing image from Docker Hub. Pullen Sie für dieses Beispiel das Image hello-world.For this example, pull the hello-world image.

docker pull hello-world

Bevor Sie ein Image mithilfe von Push in Ihre Registrierung übertragen können, müssen Sie es mit dem vollqualifizierten Namen des Anmeldeservers Ihrer Registrierungsinstanz markieren.Before you can push an image to your registry, you must tag it with the fully qualified name of your registry login server. Der Name des Anmeldeservers wird im Format <registry-name>.azurecr.io (nur Kleinbuchstaben) angegeben, z. B. mycontainerregistry.azurecr.io.The login server name is in the format <registry-name>.azurecr.io (must be all lowercase), for example, mycontainerregistry.azurecr.io.

Markieren Sie das Image mithilfe des Befehls docker tag.Tag the image using the docker tag command. Ersetzen Sie <login-server> durch den Anmeldeservernamen Ihrer ACR-Instanz.Replace <login-server> with the login server name of your ACR instance.

docker tag hello-world <login-server>/hello-world:v1

Beispiel:Example:

docker tag hello-world mycontainerregistry.azurecr.io/hello-world:v1

Nun können Sie das Image mit docker push per Pushvorgang an die Registrierungsinstanz übertragen.Finally, use docker push to push the image to the registry instance. Ersetzen Sie <login-server> durch den Anmeldeservernamen Ihrer Registrierungsinstanz.Replace <login-server> with the login server name of your registry instance. In diesem Beispiel wird das Repository hello-world mit dem Image hello-world:v1 erstellt.This example creates the hello-world repository, containing the hello-world:v1 image.

docker push <login-server>/hello-world:v1

Nachdem das Image in Ihre Containerregistrierung gepusht wurde, entfernen Sie das Image hello-world:v1 aus Ihrer lokalen Docker-Umgebung.After pushing the image to your container registry, remove the hello-world:v1 image from your local Docker environment. (Beachten Sie, dass der Befehl docker rmi nicht das Image aus dem Repository hello-world in Ihrer Azure-Containerregistrierung entfernt.)(Note that this docker rmi command does not remove the image from the hello-world repository in your Azure container registry.)

docker rmi <login-server>/hello-world:v1

Auflisten von ContainerimagesList container images

Navigieren Sie zum Auflisten der Images in Ihrer Registrierung im Portal zu Ihrer Registrierung, und wählen Sie Repositorys und dann das Repository hello-world aus, das Sie mit docker push erstellt haben.To list the images in your registry, navigate to your registry in the portal and select Repositories, then select the hello-world repository you created with docker push.

Auflisten von Containerimages im Portal

Wenn Sie das Repository hello-world auswählen, wird unter Tags das mit v1 gekennzeichnete Image angezeigt.By selecting the hello-world repository, you see the v1-tagged image under Tags.

Ausführen des Images aus der RegistrierungRun image from registry

Als Nächstes können Sie das Containerimage hello-world:v1 per Pull abrufen und mithilfe von docker run aus Ihrer Containerregistrierung ausführen:Now, you can pull and run the hello-world:v1 container image from your container registry by using docker run:

docker run <login-server>/hello-world:v1  

Beispielausgabe:Example output:

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

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

[...]

Bereinigen von RessourcenClean up resources

Navigieren Sie zum Bereinigen von Ressourcen im Portal zur Ressourcengruppe myResourceGroup.To clean up your resources, navigate to the myResourceGroup resource group in the portal. Klicken Sie nach dem Laden der Ressourcengruppe auf Ressourcengruppe löschen, um die Ressourcengruppe, die Containerregistrierung und die dort gespeicherten Containerimages zu entfernen.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.

Löschen der Ressourcengruppe im Portal

Nächste SchritteNext steps

In dieser Schnellstartanleitung haben Sie im Azure-Portal eine Azure Container Registry-Instanz erstellt, ein Containerimage per Push übertragen und das Image per Pull aus der Registrierung abgerufen und ausgeführt.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. Fahren Sie mit den Azure Container Registry-Tutorials fort, um eingehendere Informationen zu ACR zu erhalten.Continue to the Azure Container Registry tutorials for a deeper look at ACR.