Tutorial: Erstellen einer von Arc aktivierten Azure Container Registry für AKS
Gilt für: AKS in Azure Stack HCI 22H2, AKS unter Windows Server
Ein Azure Container Registry 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 Tutorial, Teil 2 von sieben, stellen Sie ein Azure Container Registry instance bereit und pushen ein Containerimage für die Verwendung in AKS. Sie lernen Folgendes:
- Erstellen einer Azure Container Registry-Instanz
- Markieren eines Containerimages für Azure Container Registry
- Hochladen des Bilds in Azure Container Registry
- Anzeigen von Images in der Registrierung
In späteren Tutorials ist dieser Azure Container Registry instance in einen Kubernetes-Cluster integriert, und eine Anwendung wird über das 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 Sei bei Bedarf unter Installieren der Azure CLI.
Erstellen einer Azure-Containerregistrierung
Zum Erstellen eines Azure Container Registry instance benötigen Sie zunächst 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 den eindeutigen Namen an, der der Containerregistrierung im vorherigen Schritt zugewiesen wurde:
az acr login --name <acrName>
Der Befehl gibt die Meldung Anmeldung erfolgreich zurück, wenn der Vorgang 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 Images 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 Containerimage azure-vote-front mit Azure Container Registry zu verwenden, müssen 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 die loginServer-Adresse 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 wurden:
docker images
Ein Image wird mit der Azure Container Registry instance Adresse und einer Versionsnummer gekennzeichnet:
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, pushen Sie das Image azure-vote-front an Ihre Azure Container Registry instance. 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 der Imagepush an Azure Container Registry abgeschlossen ist.
Auflisten von Images in der Registrierung
Verwenden Sie den Befehl az acr repository list, um eine Liste der Bilder zurückzugeben, die an Ihre Azure Container Registry instance gepusht 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 im nächsten Tutorial von Azure Container Registry in einem Kubernetes-Cluster bereitgestellt.
Nächste Schritte
In diesem Tutorial haben Sie eine Azure Container Registry erstellt und ein Image zur Verwendung in einem Kubernetes-Cluster gepusht. Es wurde Folgendes vermittelt:
- 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.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für