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.