Tutorial: Erstellen einer Azure-Containerregistrierung und Übertragen eines Containerimages per Pushvorgang

Dies ist der zweite Teil eines dreiteiligen Tutorials. In Teil 1 des Tutorials wurde ein Docker-Containerimage für eine Node.js-Webanwendung erstellt. In diesem Tutorial übertragen Sie das Image per Pushvorgang an die Azure Container Registry-Instanz. Kehren Sie zu Tutorial 1 – Erstellen von Containerimages zurück, falls Sie das Containerimage noch nicht erstellt haben.

Azure Container Registry ist Ihre private Docker-Registrierung in Azure. Dieser zweite Teil der Tutorialreihe umfasst Folgendes:

Im nächsten Artikel (dem letzten Tutorial der Reihe) stellen Sie den Container aus Ihrer privaten Registrierung für Azure Container Instances bereit.

Voraussetzungen

Für dieses Tutorial müssen folgende Voraussetzungen erfüllt sein:

Azure CLI: Auf dem lokalen Computer muss mindestens Version 2.0.29 der Azure-Befehlszeilenschnittstelle installiert sein. Führen Sie az --version aus, um die Version zu ermitteln. Installations- und Upgradeinformationen finden Sie bei Bedarf unter Installieren von Azure CLI.

Docker: In diesem Tutorial wird vorausgesetzt, dass zentrale Docker-Konzepte wie Container und Containerimages sowie grundlegende docker-Befehle bekannt sind. Eine Einführung in Docker und Container finden Sie in der Docker-Übersicht.

Docker: Für dieses Tutorial muss Docker lokal installiert sein. Für die Docker-Umgebung stehen Konfigurationspakete für macOS, Windows und Linux zur Verfügung.

Erstellen einer Azure-Containerregistrierung

Bevor Sie Ihre Containerregistrierung erstellen können, benötigen Sie eine Ressourcengruppe für die Bereitstellung. Eine Azure-Ressourcengruppe ist eine logische Sammlung, in der alle Azure-Ressourcen bereitgestellt und verwaltet werden.

Erstellen Sie mithilfe des Befehls az group create eine Ressourcengruppe. Im folgenden Beispiel wird eine Ressourcengruppe mit dem Namen myResourceGroup in der Region eastus erstellt:

az group create --name myResourceGroup --location eastus

Erstellen Sie nach der Erstellung der Ressourcengruppe mit dem Befehl az acr create eine Azure-Containerregistrierung. Der Containerregistrierungsname muss innerhalb von Azure eindeutig sein und zwischen 5 und 50 alphanumerische Zeichen enthalten. Ersetzen Sie <acrName> durch einen eindeutigen Namen für die Registrierung:

az acr create --resource-group myResourceGroup --name <acrName> --sku Basic

Hier ist ein Teil einer Ausgabe für eine neue Azure-Containerregistrierung mit dem Namen mycontainerregistry082 angegeben:

{
  "creationDate": "2020-07-16T21:54:47.297875+00:00",
  "id": "/subscriptions/<Subscription ID>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/mycontainerregistry082",
  "location": "eastus",
  "loginServer": "mycontainerregistry082.azurecr.io",
  "name": "mycontainerregistry082",
  "provisioningState": "Succeeded",
  "resourceGroup": "myResourceGroup",
  "sku": {
    "name": "Basic",
    "tier": "Basic"
  },
  "status": null,
  "storageAccount": null,
  "tags": {},
  "type": "Microsoft.ContainerRegistry/registries"
}

Im restlichen Teil dieses Tutorials wird <acrName> als Platzhalter für den von Ihnen in diesem Schritt gewählten Namen der Containerregistrierung bezeichnet.

Anmelden an der Containerregistrierung

Sie müssen sich bei der Azure-Containerregistrierung anmelden, damit Sie Images mithilfe von Push an sie übertragen können. Verwenden Sie den Befehl az acr login, um den Vorgang abzuschließen. Geben Sie den eindeutigen Namen an, den Sie beim Erstellen der Containerregistrierung gewählt haben.

az acr login --name <acrName>

Beispiel:

az acr login --name mycontainerregistry082

Der Befehl gibt nach Abschluss des Vorgangs Login Succeeded zurück:

Login Succeeded

Markieren von Containerimages

Zum Übertragen eines Containerimages an eine private Registrierung wie Azure Container Registry müssen Sie das Image zuerst mit dem vollständigen Namen des Anmeldeservers für die Registrierung versehen.

Rufen Sie zuerst den vollständigen Namen des Anmeldeservers für Ihre Containerregistrierung ab. Führen Sie den folgenden Befehl az acr show aus, und ersetzen Sie <acrName> durch den Namen der gerade erstellten Registrierung:

az acr show --name <acrName> --query loginServer --output table

Dies sieht beispielsweise wie folgt aus, wenn Ihre Registrierung den Namen mycontainerregistry082 hat:

az acr show --name mycontainerregistry082 --query loginServer --output table

Result
------------------------
mycontainerregistry082.azurecr.io

Zeigen Sie die Liste mit Ihren lokalen Images mit dem Befehl docker images an:

docker images

Neben den anderen Images, die auf Ihrem Computer vorhanden sind, sollte das Image aci-tutorial-app angezeigt werden, das Sie im vorherigen Tutorial erstellt haben:

docker images

REPOSITORY          TAG       IMAGE ID        CREATED           SIZE
aci-tutorial-app    latest    5c745774dfa9    39 minutes ago    68.1 MB

Kennzeichnen Sie das Image aci-tutorial-app mit dem Anmeldeserver der Containerregistrierung. Fügen Sie außerdem das Tag :v1 am Ende des Imagenamens hinzu, um die Versionsnummer für das Image anzugeben. Ersetzen Sie <acrLoginServer> durch das Ergebnis des zuvor ausgeführten Befehls az acr show.

docker tag aci-tutorial-app <acrLoginServer>/aci-tutorial-app:v1

Führen Sie docker images erneut aus, um zu überprüfen, ob die Kennzeichnung erfolgreich war:

docker images

REPOSITORY                                            TAG       IMAGE ID        CREATED           SIZE
aci-tutorial-app                                      latest    5c745774dfa9    39 minutes ago    68.1 MB
mycontainerregistry082.azurecr.io/aci-tutorial-app    v1        5c745774dfa9    7 minutes ago     68.1 MB

Übertragen des Images zu Azure Container Registry mithilfe von Push

Nachdem Sie das Image aci-tutorial-app jetzt mit dem vollständigen Namen des Anmeldeservers Ihrer privaten Registrierung versehen haben, können Sie es mit dem Befehl docker push per Pushvorgang an die Registrierung übertragen. Ersetzen Sie <acrLoginServer> durch den vollständigen Anmeldeservernamen, den Sie im vorherigen Schritt abgerufen haben.

docker push <acrLoginServer>/aci-tutorial-app:v1

Der push-Vorgang dauert abhängig von der Internetverbindung zwischen einigen Sekunden und wenigen Minuten. Die Ausgabe sieht ungefähr wie folgt aus:

docker push mycontainerregistry082.azurecr.io/aci-tutorial-app:v1

The push refers to a repository [mycontainerregistry082.azurecr.io/aci-tutorial-app]
3db9cac20d49: Pushed
13f653351004: Pushed
4cd158165f4d: Pushed
d8fbd47558a8: Pushed
44ab46125c35: Pushed
5bef08742407: Pushed
v1: digest: sha256:ed67fff971da47175856505585dcd92d1270c3b37543e8afd46014d328f05715 size: 1576

Auflisten der Images in Azure Container Registry

Um sicherzustellen, dass sich das gerade übertragene Image wirklich in Ihrer Azure-Containerregistrierung befindet, können Sie die in der Registrierung enthaltenen Images mit dem Befehl az acr repository list auflisten. Ersetzen Sie <acrName> durch den Namen Ihrer Containerregistrierung.

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

Zum Beispiel:

az acr repository list --name mycontainerregistry082 --output table

Result
----------------
aci-tutorial-app

Verwenden Sie den Befehl az acr repository show-tags, um die Tags für ein bestimmtes Image anzuzeigen.

az acr repository show-tags --name <acrName> --repository aci-tutorial-app --output table

Die Ausgabe sollte etwa folgendermaßen aussehen:

--------
v1

Nächste Schritte

In diesem Tutorial haben Sie eine Azure-Containerregistrierung für die Verwendung mit Azure Container Instances vorbereitet und ein Containerimage mithilfe von Push an die Registrierung übertragen. Die folgenden Schritte wurden durchgeführt:

Fahren Sie mit dem nächsten Tutorial fort, um zu erfahren, wie Sie den Container in Azure mithilfe von Azure Container Instances bereitstellen: