Zelfstudie: Azure Container Registry implementeren en gebruiken

Azure Container Registry (ACR) is een privéregister voor installatiekopieën van de container. Een particulier containerregister stelt u in staat om op een veilige manier toepassingen en aangepaste code te bouwen en implementeren. In deze zelfstudie, deel twee van zeven, implementeert u een ACR-exemplaar en pusht u vervolgens een containerinstallatiekopie naar het exemplaar. In deze zelfstudie leert u procedures om het volgende te doen:

  • Een ACR-exemplaar (Azure Container Registry) maken
  • Een containerinstallatiekopie voor ACR taggen
  • De installatiekopie uploaden naar ACR
  • Installatiekopieën weergeven in het register

In latere zelfstudies wordt dit ACR-exemplaar geïntegreerd met een Kubernetes-cluster in AKS en wordt er een toepassing geïmplementeerd vanuit de -afbeelding.

Voordat u begint

In de vorige zelfstudie hebt u een containerinstallatiekopie voor een eenvoudige Azure Voting-toepassing gemaakt. Als u de installatiekopie voor de Azure Voting-toepassing niet hebt gemaakt, ga dan terug naar Zelfstudie 1: Containerinstallatiekopieën maken.

Voor deze zelfstudie moet u Azure CLI versie 2.0.53 of hoger uitvoeren. Voer az --version uit om de versie te bekijken. Zie Azure CLI installeren als u de CLI wilt installeren of een upgrade wilt uitvoeren.

Een Azure Container Registry maken

Om een Azure-containerregister te maken, hebt u eerst een resourcegroep nodig. Een Azure-resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd.

Een resourcegroep maken met de opdracht az group create. In het volgende voorbeeld wordt een resourcegroep met de naam myResourceGroup gemaakt in de regio eastus:

az group create --name myResourceGroup --location eastus

Maak een Azure Container Registry-exemplaar met de opdracht az acr create en geef de naam van uw register op. De registernaam moet uniek zijn binnen Azure en mag 5 tot 50 alfanumerieke tekens bevatten. In de rest van deze zelfstudie wordt <acrName> gebruikt als een tijdelijke aanduiding voor de naam van het containerregister. Geef een unieke naam voor uw register op. De SKU Basic is een toegangspunt voor ontwikkelingsdoeleinden dat is geoptimaliseerd voor kosten, met een balans tussen opslag en doorvoer.

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

Aanmelden bij het containerregister

Als u het ACR-exemplaar wilt gebruiken, moet u zich eerst aanmelden. Gebruik de opdracht az acr login en voer de unieke naam in die u in de vorige stap aan het containerregister hebt gegeven.

az acr login --name <acrName>

De opdracht retourneert het bericht Aanmelden geslaagd wanneer deze is uitgevoerd.

Een containerinstallatiekopie taggen

Als u een lijst met de huidige installatiekopieën wilt weergeven, gebruikt u de opdracht docker images:

docker images

In de uitvoer van de bovenstaande opdracht ziet u een lijst met uw huidige lokale afbeeldingen:

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

Als u de containerinstallatiekopie azure-vote-front wilt gebruiken met ACR, moet de installatiekopie worden getagd met het adres van de aanmeldingsserver van uw register. Deze tag wordt gebruikt voor routering bij het pushen van containerinstallatiekopieën naar een installatiekopieregister.

U kunt het adres van de aanmeldingsserver opvragen door met de opdracht az acr list als volgt een query uit te voeren op de loginServer:

az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table

Tag nu de lokale installatiekopie azure-vote-front met het adres acrloginServer van het containerregister. U kunt de versie van de installatiekopie aangeven door :v1 toe te voegen aan het eind van de naam van de installatiekopie:

docker tag mcr.microsoft.com/azuredocs/azure-vote-front:v1 <acrLoginServer>/azure-vote-front:v1

Controleer of de tags zijn toegepast door docker images opnieuw uit te voeren.

docker images

Een installatiekopie wordt getagd met het adres van het ACR-exemplaar en een versienummer.

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

Installatiekopieën naar het register pushen

U kunt de gemaakte en getagde installatiekopie azure-vote-front nu pushen naar het ACR-exemplaar. Gebruik docker push en geef als volgt uw eigen acrLoginServer-adres op voor de naam van de installatiekopie:

docker push <acrLoginServer>/azure-vote-front:v1

Het kan enkele minuten duren voordat de installatiekopie naar ACR is gepusht.

Installatiekopieën vermelden in het register

Gebruik de opdracht az acr repository list om een lijst weer te geven met installatiekopieën die naar het ACR-exemplaar zijn gepusht. Geef als volgt uw eigen <acrName> op:

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

In het volgende voorbeeld van uitvoer ziet u dat de installatiekopie azure-vote-front beschikbaar is in het register:

Result
----------------
azure-vote-front

Gebruik de opdracht az acr repository show-tags als volgt om de tags voor een specifieke installatiekopie te zien:

az acr repository show-tags --name <acrName> --repository azure-vote-front --output table

In het volgende voorbeeld van uitvoer ziet u de tag v1 zoals toegevoegd aan de installatiekopie in een eerdere stap:

Result
--------
v1

U beschikt nu over een containerinstallatiekopie die is opgeslagen in een particulier Azure Container Registry-exemplaar. Deze installatiekopie wordt in de volgende zelfstudie vanuit ACR geïmplementeerd naar een Kubernetes-cluster.

Volgende stappen

In deze zelfstudie hebt u een Azure Container Registry gemaakt en een installatiekopie gepusht voor gebruik in een AKS-cluster. U hebt geleerd hoe u:

  • Een ACR-exemplaar (Azure Container Registry) maken
  • Een containerinstallatiekopie voor ACR taggen
  • De installatiekopie uploaden naar ACR
  • Installatiekopieën weergeven in het register

Ga naar de volgende zelfstudie voor informatie over het implementeren van een Kubernetes-cluster in Azure.