Zelfstudie: Azure Container Registry (ACR) implementeren en gebruiken
Azure Container Registry (ACR) is een privéregister voor installatiekopieën van de container. Met een privécontainerregister kunt u veilig uw toepassingen en aangepaste code 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 maken
- Een containerinstallatiekopie voor ACR taggen
- De installatiekopie uploaden naar ACR
- Installatiekopieën weergeven in het register
In latere zelfstudies integreert u uw ACR-exemplaar met een Kubernetes-cluster in AKS en implementeert u een toepassing vanuit de installatiekopieën.
Voordat u begint
In de vorige zelfstudie hebt u een containerinstallatiekopieën gemaakt voor een eenvoudige Azure Voting-toepassing. Als u de installatiekopieën van de Azure Voting-app nog niet hebt gemaakt, gaat u terug naar Zelfstudie 1: Een toepassing voorbereiden voor AKS.
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
Voordat u een ACR maakt, hebt u een resourcegroep nodig. Een Azure-resourcegroep is een logische container waarin u Azure-resources implementeert en beheert.
- Maak een resourcegroep met de opdracht
az group create.
az group create --name myResourceGroup --location eastus
- Maak een ACR-exemplaar met de
az acr createopdracht en geef uw eigen unieke registernaam 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. 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
Meld u aan bij uw ACR met de az acr login opdracht en geef de unieke naam op die in de vorige stap aan het containerregister is gegeven.
az acr login --name <acrName>
De opdracht retourneert het bericht Aanmelden geslaagd wanneer deze is uitgevoerd.
Een containerinstallatiekopie taggen
Gebruik de docker images opdracht om een lijst met uw huidige lokale installatiekopieën weer te geven.
docker images
In de volgende voorbeelduitvoer ziet u een lijst met de huidige lokale Docker-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
Als u de containerinstallatiekopieën azure-vote-front met ACR wilt gebruiken, moet u de installatiekopieën taggen met het adres van de aanmeldingsserver van uw register. De tag wordt gebruikt voor routering bij het pushen van containerinstallatiekopieën naar een installatiekopieënregister.
Als u het adres van de aanmeldingsserver wilt ophalen, gebruikt u de az acr list opdracht en query voor de loginServer.
az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table
Tag vervolgens uw lokale azure-vote-front-installatiekopieën met het acrLoginServer-adres 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 images opnieuw uit om te controleren of de tags zijn toegepast.
docker images
In de volgende voorbeelduitvoer ziet u een afbeelding die is 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
Installatiekopieën naar het register pushen
Push de installatiekopieën azure-vote-front naar uw ACR-exemplaar met behulp van de docker push opdracht . Zorg ervoor dat u uw eigen acrLoginServer-adres opgeeft voor de naam van de installatiekopieën.
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
Als u een lijst met installatiekopieën wilt retourneren die naar uw ACR-exemplaar zijn gepusht, gebruikt u de az acr repository list opdracht om uw eigen <acrName>op te geven.
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 az acr repository show-tags de opdracht om de tags voor een specifieke afbeelding weer te geven.
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
Volgende stappen
In deze zelfstudie hebt u een ACR gemaakt en een installatiekopieën gepusht voor gebruik in een AKS-cluster. U hebt geleerd hoe u:
- Een ACR-exemplaar maken
- Een containerinstallatiekopie voor ACR taggen
- De installatiekopie uploaden naar ACR
- Installatiekopieën weergeven in het register
In de volgende zelfstudie leert u hoe u een Kubernetes-cluster implementeert in Azure.