Zelfstudie: Een Azure Container Registry maken voor AKS ingeschakeld door Arc
Van toepassing op: AKS in Azure Local 22H2, AKS op Windows Server
Een Azure Container Registry is een privéregister voor containerinstallatiekopieën. Een particulier containerregister stelt u in staat om op een veilige manier toepassingen en aangepaste code te bouwen en implementeren.
In deze zelfstudie implementeert u deel twee van zeven een Azure Container Registry-exemplaar en pusht u er een containerinstallatiekopieën naartoe voor gebruik in AKS. U leert het volgende:
- Een Azure Container Registry-exemplaar maken
- Een containerinstallatiekopieën taggen voor Azure Container Registry
- De installatiekopieën uploaden naar Azure Container Registry
- Installatiekopieën weergeven in het register
In latere zelfstudies is dit Azure Container Registry-exemplaar geïntegreerd met een Kubernetes-cluster en wordt een toepassing geïmplementeerd vanuit de installatiekopie.
Voordat u begint
In de vorige zelfstudie werd beschreven hoe u een containerinstallatiekopieën maakt voor een eenvoudige Azure Voting-toepassing. 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. Als u Azure CLI 2.0 wilt installeren of upgraden, raadpleegt u Azure CLI 2.0 installeren.
Een Azure Container Registry maken
Als u een Azure Container Registry-exemplaar wilt 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 geef de unieke naam op die is gegeven aan het containerregister in de vorige stap:
az acr login --name <acrName>
De opdracht retourneert een bericht geslaagde aanmelding wanneer deze is voltooid.
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 deze opdracht ziet u een lijst met uw huidige lokale installatiekopieën:
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 azure-vote-front-containerinstallatiekopieën wilt gebruiken met Azure Container Registry, moet u ervoor zorgen dat u de installatiekopieën tagt 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
Voer docker-installatiekopieën opnieuw uit om te controleren of de tags zijn toegepast:
docker images
Een installatiekopieën worden getagd met het azure Container Registry-exemplaaradres 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
Wanneer uw installatiekopie is gebouwd en getagd, pusht u de azure-vote-front-installatiekopie naar uw Azure Container Registry-exemplaar. Gebruik docker-push en geef als volgt uw eigen acrLoginServer adres op voor de naam van de installatiekopieën:
docker push <acrLoginServer>/azure-vote-front:v1
Het kan enkele minuten duren voordat de installatiekopieën naar Azure Container Registry zijn gepusht.
Installatiekopieën vermelden in het register
Gebruik de opdracht az acr repository list om een lijst met installatiekopieën te retourneren die naar uw Azure Container Registry-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
Als u de tags voor een specifieke installatiekopieën wilt bekijken, gebruikt u de opdracht az acr repository show-tags :
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 vanuit Azure Container Registry geïmplementeerd in een Kubernetes-cluster in de volgende zelfstudie.
Volgende stappen
In deze zelfstudie hebt u een Azure Container Registry gemaakt en een installatiekopieën gepusht voor gebruik in een Kubernetes-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.