Freigeben über

Übertragen Ihres ersten Images in Ihre Azure-Containerregistrierung mithilfe der Docker CLI

Eine Azure-Containerregistrierung dient zum Speichern und Verwalten privater Containerimages und anderer Artefakte, ähnlich wie in Docker Hub öffentliche Docker-Containerimages gespeichert werden. Sie können die Docker-Befehlszeilenschnittstelle (Docker CLI) für Anmeldung, Push, Pull und andere Vorgänge für Containerimages in Ihrer Containerregistrierung verwenden.

In den folgenden Schritten laden Sie ein öffentliches Nginx-Image herunter, taggen es für Ihre private Azure-Containerregistrierung, laden es in Ihre Registrierung hoch und laden es anschließend von Ihrer Registrierung wieder herunter.

Voraussetzungen

  • Ein Azure-Abonnement. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
  • Eine Azure-Containerregistrierung in Ihrem Azure-Abonnement. Sie können eine erstellen, indem Sie das Azure-Portal, die Azure CLI oder Azure PowerShell verwenden.
  • Sie müssen Docker auch lokal installiert haben. Für Docker sind Pakete erhältlich, mit denen Docker auf einem macOS-, Windows- oder Linux-System problemlos konfiguriert werden kann.

Anmelden bei Ihrer Containerregistrierung

Es gibt mehrere Möglichkeiten, sich bei Ihrer Containerregistrierung zu authentifizieren .

Die empfohlene Methode beim Arbeiten in einer Befehlszeile ist die Verwendung des Azure CLI-Befehls az acr login. Um auf eine Registrierung mit dem Namen myregistryzuzugreifen, melden Sie sich bei der Azure CLI an, und authentifizieren Sie sich dann bei Ihrer Registrierung:

az login
az acr login --name myregistry

Sie können sich auch mit docker login anmelden. Bewährte Methoden zum Verwalten von Authentifizierungsanmeldeinformationen finden Sie in der Docker-Anmeldebefehlsreferenz .

Angenommen, Sie haben Ihrer Registrierung für ein Automatisierungsszenario einen Dienstprinzipal zugewiesen. Wenn Sie den folgenden Befehl ausführen, geben Sie bei Aufforderung interaktiv die Haupt-AppID (Benutzername) und das Kennwort des Dienstes an:

docker login myregistry.azurecr.io

Tipp

Geben Sie immer den vollqualifizierten Registrierungsnamen (nur Kleinbuchstaben) an, wenn Sie docker login verwenden und Images für die Pushübertragung in Ihre Registrierung kennzeichnen. In den Beispielen in diesem Artikel wird der vollqualifizierte Name myregistry.azurecr.io verwendet.

Herunterladen eines öffentlichen Nginx-Images

Pullen Sie zunächst das öffentliche Nginx-Image auf Ihren lokalen Computer. Dieses Beispiel pullt das offizielle Nginx-Image.

docker pull nginx

Den Container lokal ausführen

Verwenden Sie den Befehl "Docker-Ausführen ", um eine lokale Instanz des Nginx-Containers interaktiv (-it) auf Port 8080 zu starten. Das Argument --rm gibt an, dass der Container entfernt werden soll, wenn Sie ihn beenden.

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

Navigieren Sie zu http://localhost:8080, um die von NGINX bereitgestellte Standardwebseite im ausgeführten Container anzuzeigen. Eine Seite ähnlich der folgenden wird angezeigt:

Nginx auf lokalem Computer

Da Sie den Container interaktiv mit -it gestartet haben, können Sie nach dem Navigieren im Browser die Ausgabe des Nginx-Servers in der Befehlszeile sehen.

Drücken Sie zum Beenden und Entfernen des Containers die Tastenkombination Ctrl+C.

Erstellen eines Alias des Images

Verwenden Sie docker tag, um einen Alias des Images mit vollqualifiziertem Pfad zur Registrierung zu erstellen. In diesem Beispiel wird der samples-Namespace angegeben, um den Stamm der Registrierung nicht zu überladen.

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

Weitere Informationen zum Tagging mit Namespaces finden Sie in den bewährten Methoden für Repository-Namespaces](container-registry-best-practices.md#repository-namespaces).

Übertragen des Images per Push in Ihre Registrierung

Nachdem Sie das Image mit dem vollqualifizierten Pfad zu Ihrer privaten Registrierung gekennzeichnet haben, können Sie es nun mit docker push in die Registrierung pushen.

docker push myregistry.azurecr.io/samples/nginx

Ziehe das Image aus Ihrer Registry

Verwenden Sie den Befehl docker pull, um das Image per Pullvorgang aus Ihrer Registrierung zu übertragen:

docker pull myregistry.azurecr.io/samples/nginx

Starten des Nginx-Containers

Verwenden Sie den Befehl "Docker-Ausführen ", um das Image auszuführen, das Sie aus Ihrer Registrierung abgerufen haben:

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

Navigieren Sie zu http://localhost:8080, um den ausgeführten Container anzuzeigen.

Drücken Sie zum Beenden und Entfernen des Containers die Tastenkombination Ctrl+C.

Entfernen des Images (optional)

Wenn Sie das Nginx-Image nicht mehr benötigen, können Sie es mit dem Befehl docker rmi lokal löschen.

docker rmi myregistry.azurecr.io/samples/nginx

Um Bilder aus Ihrer Azure-Containerregistrierung zu entfernen, verwenden Sie az acr repository delete. Mit dem folgenden Befehl werden beispielsweise das durch das samples/nginx:latest-Tag referenzierte Manifest, alle eindeutigen Ebenendaten und alle anderen Tags gelöscht, die auf das Manifest verweisen.

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

Nächste Schritte

Nachdem Sie die Grundlagen kennen, können Sie mit der Verwendung Ihrer Registrierung beginnen. Stellen Sie beispielsweise Containerimages aus Ihrer Registrierung bereit:

  • Last updated on