Tutorial: Erstellen einer Azure Container Registry-Instanz (ACR) und Erstellen von Images

2025-07-14

Bei Azure Container Registry (ACR) handelt es sich um 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 stellen Sie eine ACR-Instanz bereit und übertragen ein Container-Image darauf. Folgendes wird vermittelt:

Erstellen einer ACR-Instanz
Verwenden von ACR Tasks, um Containerimages zu erstellen und in ACR zu pushen
Anzeigen von Images in der Registrierung

Voraussetzungen

Im vorherigen Tutorial wurde beschrieben, wie Sie mithilfe von Docker ein Containerimage für eine einfache Azure Store Front-Anwendung erstellen. Wenn Sie das Image der Azure Store Front-App nicht erstellt haben, kehren Sie zu Tutorial 1: Vorbereiten einer Anwendung für AKS zurück.

Azure-Befehlszeilenschnittstelle
Azure PowerShell

Für dieses Tutorial wird mindestens Version 2.0.53 der Azure-Befehlszeilenschnittstelle vorausgesetzt. 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 einer ACR-Instanz benötigen Sie zunächst eine Ressourcengruppe. Eine Azure-Ressourcengruppe ist ein logischer Container, in dem Sie Azure-Ressourcen bereitstellen und verwalten.

Wichtig

In diesem Tutorial wird myResourceGroup als Platzhalter für den Ressourcengruppennamen verwendet. Wenn Sie einen anderen Namen verwenden möchten, ersetzen Sie myResourceGroup durch Ihren eigenen Ressourcengruppennamen.

Azure-Befehlszeilenschnittstelle
Azure PowerShell

Erstellen Sie mit dem Befehl az group create eine Ressourcengruppe.
```
az group create --name myResourceGroup --___location westus2
```
Erstellen Sie mit dem Befehl az acr create eine ACR-Instanz, und geben Sie einen eigenen eindeutigen Registrierungsnamen an. Der Registrierungsname muss in Azure eindeutig sein und 5-50 alphanumerische Zeichen enthalten. In dieser Tutorialreihe wird eine Umgebungsvariable, $ACRNAME, als Platzhalter für den Containerregistrierungsnamen verwendet. Sie können diese Umgebungsvariable auf Ihren eindeutigen ACR-Namen festlegen, der in zukünftigen Befehlen verwendet werden soll. 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
```

Erstellen Sie eine Ressourcengruppe mit dem Cmdlet New-AzResourceGroup.
```
New-AzResourceGroup -Name myResourceGroup -Location westus2
```
Erstellen Sie mit dem Cmdlet New-AzContainerRegistry eine ACR-Instanz, und geben Sie einen eigenen eindeutigen Registrierungsnamen an. Der Registrierungsname muss in Azure eindeutig sein und 5-50 alphanumerische Zeichen enthalten. Im restlichen Tutorial wird die Umgebungsvariable $ACRNAME als Platzhalter für den Namen der Containerregistrierung verwendet. Sie können diese Umgebungsvariable auf Ihren eindeutigen ACR-Namen festlegen, der in zukünftigen Befehlen verwendet werden soll. Die Basic-SKU ist ein kostenoptimierter Einstiegspunkt für Entwicklungszwecke, der ein ausgewogenes Verhältnis von Speicher und Durchsatz bietet.
```
$rand=New-Object System.Random
$RAND=$rand.Next()
$ACRNAME="myregistry$RAND" # Or replace with your own name
New-AzContainerRegistry -ResourceGroupName myResourceGroup -Name $ACRNAME -Location westus2 -Sku Basic
```

Erstellen von Containerimages und Pushen der Images in die Registrierung

Erstellen Sie die Images und übertragen Sie sie mit dem Azure CLI az acr build-Befehl auf Ihr ACR.

Hinweis

Für diesen Schritt gibt es kein entsprechendes Azure PowerShell-Cmdlet, das diese Aufgabe ausführt.

Im folgenden Beispiel wird das Image product-service nicht erstellt. Der Aufbau dieses Images kann lange dauern, aber es ist bereits ein Container-Image in der GitHub Container Registry (GHCR) dort verfügbar. Sie können den az acr import Befehl verwenden, um das Bild aus dem GHCR in Ihre ACR-Instanz zu importieren. Wir erstellen das rabbitmq Image auch nicht. Dieses Image ist im öffentlichen Docker Hub-Repository verfügbar und muss nicht erstellt oder in Ihre ACR-Instanz gepusht werden.
```
az acr import --name $ACRNAME --source ghcr.io/azure-samples/aks-store-demo/product-service:latest --image aks-store-demo/product-service:latest
az acr build --registry $ACRNAME --image aks-store-demo/order-service:latest ./src/order-service/
az acr build --registry $ACRNAME --image aks-store-demo/store-front:latest ./src/store-front/
```

Auflisten von Images in der Registrierung

Azure-Befehlszeilenschnittstelle
Azure PowerShell

Zeigen Sie die Images in Ihrer ACR-Instanz mithilfe des Befehls az acr repository list an.
```
az acr repository list --name $ACRNAME --output table
```
Die folgende Beispielausgabe listet die verfügbaren Images in Ihrer Registrierung auf:
```
Result
----------------
aks-store-demo/product-service
aks-store-demo/order-service
aks-store-demo/store-front
```

Zeigen Sie die Images in Ihrer ACR-Instanz mithilfe des Cmdlets Get-AzContainerRegistryRepository an.
```
Get-AzContainerRegistryRepository -RegistryName $ACRNAME
```
Die folgende Beispielausgabe listet die verfügbaren Images in Ihrer Registrierung auf:
```
aks-store-demo/productservice
aks-store-demo/orderservice
aks-store-demo/storefront
```

Nächste Schritte

In diesem Tutorial haben Sie eine ACR-Instanz erstellt und Images per Push für die Verwendung in einem AKS-Cluster übertragen. Sie haben Folgendes gelernt:

Erstellen einer ACR-Instanz
Verwenden von ACR Tasks, um Containerimages zu erstellen und in ACR zu pushen
Anzeigen von Images in der Registrierung

Im nächsten Tutorial erfahren Sie, wie Sie einen Kubernetes-Cluster in Azure bereitstellen.

Bereitstellen von Kubernetes-Clustern

Feedback

War diese Seite hilfreich?