Lernprogramm: Erstellen einer Azure-Containerregistrierung für von Arc aktivierte AKS
Gilt für: AKS auf Azure Stack HCI 22H2, AKS unter Windows Server
Eine Azure-Containerregistrierung ist eine private Registrierung für Containerimages. Mit einer privaten Containerregistrierung können Sie Ihre Anwendungen und benutzerdefinierten Code auf sichere Weise erstellen und bereitstellen.
In diesem Lernprogramm, Teil 2 von sieben, stellen Sie eine Azure-Containerregistrierungsinstanz bereit und pushen ein Containerimage für die Verwendung in AKS. Sie lernen Folgendes:
- Erstellen einer Azure Container Registry-Instanz
- Kategorisieren eines Containerimages für die Azure-Containerregistrierung
- Hochladen des Images in Azure Container Registry
- Anzeigen von Images in der Registrierung
In späteren Lernprogrammen ist diese Azure Container Registry-Instanz in einen Kubernetes-Cluster integriert, und eine Anwendung wird aus dem Image bereitgestellt.
Voraussetzungen
Im vorherigen Tutorial wurde beschrieben, wie Sie ein Containerimage für eine einfache Azure Voting-Anwendung erstellen. Wenn Sie das Image der Azure Voting-App noch nicht erstellt haben, kehren Sie zum Tutorial 1 – Erstellen von Containerimages zurück.
Für dieses Tutorial müssen Sie mindestens Version 2.0.53 der Azure CLI ausführen. Führen Sie az --version aus, um die Version zu ermitteln. Informationen zum Durchführen einer Installation oder eines Upgrades finden Sie bei Bedarf unter Installieren der Azure CLI.
Erstellen einer Azure-Containerregistrierung
Um eine Azure Container Registry-Instanz zu erstellen, benötigen Sie zuerst eine Ressourcengruppe. Eine Azure-Ressourcengruppe ist ein logischer Container, in dem 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 mit dem Befehl az acr create eine Azure Container Registry-Instanz, und geben Sie einen eigenen Registrierungsnamen an. Der Registrierungsname muss innerhalb von Azure eindeutig sein und zwischen 5 und 50 alphanumerische Zeichen enthalten. Im weiteren Verlauf dieses Tutorials wird <acrName> als Platzhalter für den Namen der Containerregistrierung verwendet. Geben Sie Ihren eigenen eindeutigen Registrierungsnamen an. Die Basic-SKU ist ein kostenoptimierter Einstiegspunkt für Entwicklungszwecke, der ein ausgewogenes Verhältnis von Speicher und Durchsatz bietet.
az acr create --resource-group myResourceGroup --name <acrName> --sku Basic
Anmelden bei der Containerregistrierung
Zur Verwendung der ACR-Instanz müssen Sie sich zunächst anmelden. Verwenden Sie den Befehl "az acr login " und geben Sie im vorherigen Schritt den eindeutigen Namen der Containerregistrierung an:
az acr login --name <acrName>
Der Befehl gibt eine Meldung "Anmeldung erfolgreich" zurück, wenn sie abgeschlossen ist.
Markieren eines Containerimages
Verwenden Sie den Befehl docker images, um eine Liste Ihrer aktuellen lokalen Images anzuzeigen:
docker images
Die Ausgabe dieses Befehls zeigt eine Liste Ihrer aktuellen lokalen Bilder an:
REPOSITORY TAG IMAGE ID CREATED SIZE
mcr.microsoft.com/azuredocs/azure-vote-front v1 84b41c268ad9 7 minutes ago 944MB
mcr.microsoft.com/oss/bitnami/redis 6.0.8 3a54a920bb6c 2 days ago 103MB
tiangolo/uwsgi-nginx-flask python3.6 a16ce562e863 6 weeks ago 944MB
Um das Azure-Vote-Front-Containerimage mit der Azure-Containerregistrierung zu verwenden, stellen Sie sicher, dass Sie das Image mit der Anmeldeserveradresse Ihrer Registrierung markieren. Dieses Tag wird beim Übertragen von Containerimages per Push in eine Imageregistrierung für das Routing verwendet.
Führen Sie den Befehl az acr list aus, um die Anmeldeserveradresse abzurufen, und fragen Sie loginServer wie folgt ab:
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. Fügen Sie am Ende des Imagenamens :v1 hinzu, um die Imageversion anzugeben:
docker tag mcr.microsoft.com/azuredocs/azure-vote-front:v1 <acrLoginServer>/azure-vote-front:v1
Führen Sie Docker-Images erneut aus, um zu überprüfen, ob die Tags angewendet werden:
docker images
Ein Bild wird mit der Azure Container Registry-Instanzadresse und einer Versionsnummer markiert:
REPOSITORY TAG IMAGE ID CREATED SIZE
mcr.microsoft.com/azuredocs/azure-vote-front v1 84b41c268ad9 16 minutes ago 944MB
mycontainerregistry.azurecr.io/azure-vote-front v1 84b41c268ad9 16 minutes ago 944MB
mcr.microsoft.com/oss/bitnami/redis 6.0.8 3a54a920bb6c 2 days ago 103MB
tiangolo/uwsgi-nginx-flask python3.6 a16ce562e863 6 weeks ago 944MB
Übertragen von Images in die Registrierung per Push
Wenn Ihr Image erstellt und markiert ist, verschieben Sie das Azure-Abstimmungs-Front-Image an Ihre Azure Container Registry-Instanz. Verwenden Sie Docker-Push, und geben Sie Ihre eigene acrLoginServer Adresse für den Imagenamen wie folgt an:
docker push <acrLoginServer>/azure-vote-front:v1
Es kann einige Minuten dauern, bis das Image-Push an die Azure-Containerregistrierung erfolgt.
Auflisten von Images in der Registrierung
Verwenden Sie den Befehl az acr repository list list , um eine Liste der Bilder zurückzugeben, die an Ihre Azure Container Registry-Instanz übertragen wurden. Geben Sie Ihren eigenen <acrName>-Wert wie folgt an:
az acr repository list --name <acrName> --output table
Die folgende Beispielausgabe listet das Image azure-vote-front in der Registrierung als verfügbar auf:
Result
----------------
azure-vote-front
Verwenden Sie den Befehl "az acr repository show-tags ", um die Tags für ein bestimmtes Bild anzuzeigen:
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:
Result
--------
v1
Sie verfügen jetzt über ein Containerimage, das in einer privaten Azure Container Registry-Instanz gespeichert ist. Dieses Image wird aus der Azure Container Registry in einem Kubernetes-Cluster im nächsten Lernprogramm bereitgestellt.
Nächste Schritte
In diesem Lernprogramm haben Sie eine Azure-Containerregistrierung erstellt und ein Image für die Verwendung in einem Kubernetes-Cluster pusht. Sie haben Folgendes gelernt:
- Erstellen einer Azure Container Registry-Instanz (ACR)
- Kennzeichnen eines Containerimages für ACR
- Hochladen des Images in die ACR-Instanz
- Anzeigen von Images in der Registrierung
Im nächsten Tutorial erfahren Sie, wie Sie einen Kubernetes-Cluster in Azure bereitstellen.