Självstudie: Distribuera och använda Azure Container Registry (ACR)

  • Artikel

Azure Container Registry (ACR) är ett privat register för containeravbildningar. Med ett privat containerregister kan du på ett säkert sätt skapa och distribuera dina program och anpassad kod. I den här självstudien, del två av sju, ska du distribuera en ACR-instans och skicka en containeravbildning till den. Lär dig att:

  • Skapa en ACR-instans
  • Tagga en containeravbildning för ACR
  • ladda upp avbildningen till ACR.
  • Visa avbildningar i registret

I senare självstudier integrerar du din ACR-instans med ett Kubernetes-kluster i AKS och distribuerar ett program från avbildningen.

Innan du börjar

I den föregående självstudien skapade du en containeravbildning för ett enkelt Azure Voting-program. Om du inte har skapat Azure Voting-appbilden går du tillbaka till Självstudie 1: Förbereda ett program för AKS.

Den här självstudien kräver att du kör Azure CLI version 2.0.53 eller senare. Kör az --version för att hitta versionen. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.

Skapa ett Azure Container Registry

Innan du skapar en ACR behöver du en resursgrupp. En Azure-resursgrupp är en logisk container där du distribuerar och hanterar Azure-resurser.

  1. Skapa en resursgrupp med kommandot az group create.
az group create --name myResourceGroup --location eastus
  1. Skapa en ACR-instans med az acr create kommandot och ange ditt eget unika registernamn. Registernamnet måste vara unikt i Azure och innehålla 5–50 alfanumeriska tecken. I resten av den här självstudien används <acrName> som platshållare för namnet på containerregistret. Den grundläggande SKU:n är en kostnadsoptimerad startpunkt för utvecklingsändamål som ger en bra balans mellan lagring och dataflöde.
az acr create --resource-group myResourceGroup --name <acrName> --sku Basic

Logga in till containerregistret

Logga in på din ACR med az acr login kommandot och ange det unika namnet som angavs för containerregistret i föregående steg.

az acr login --name <acrName>

Kommandot returnerar ett meddelande om att inloggningen lyckades när den har slutförts.

Tagga en containeravbildning

Om du vill se en lista över dina aktuella lokala avbildningar använder du docker images kommandot .

docker images

Följande exempelutdata visar en lista över aktuella lokala Docker-avbildningar:

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

Om du vill använda containeravbildningen azure-vote-front med ACR måste du tagga avbildningen med inloggningsserveradressen för registret. Taggen används för routning när containeravbildningar skickas till ett avbildningsregister.

Om du vill hämta inloggningsserveradressen az acr list använder du kommandot och frågan för loginServer.

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

Tagga sedan din lokala azure-vote-front-avbildning med acrLoginServer-adressen för containerregistret. Ange versionsnumret för avbildningen genom att lägga till :v1 i slutet av avbildningens namn:

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

Kontrollera att taggarna tillämpas genom att köra docker images igen.

docker images

Följande exempelutdata visar en bild taggad med ACR-instansadressen och ett versionsnummer:

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

Push-överför avbildningar till registret

Push-överför azure-vote-front-avbildningendocker push till din ACR-instans med kommandot . Se till att ange din egen acrLoginServer-adress för avbildningsnamnet.

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

Överföringen till ACR kan ta några minuter.

Lista med avbildningar i registret

Om du vill returnera en lista över avbildningar som har push-överförts till din ACR-instans använder du az acr repository list kommandot och tillhandahåller din egen <acrName>.

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

Följande exempelutdata visar azure-vote-front-avbildningen i registret:

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

Om du vill se taggarna för en viss avbildning använder du az acr repository show-tags kommandot .

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

Följande exempelutdata visar v1-avbildningen som taggades i föregående steg:

Result
--------
v1

Nästa steg

I den här självstudien skapade du en ACR och push-överförde en avbildning som ska användas i ett AKS-kluster. Du har lärt dig att:

  • Skapa en ACR-instans
  • Tagga en containeravbildning för ACR
  • ladda upp avbildningen till ACR.
  • Visa avbildningar i registret

I nästa självstudie får du lära dig hur du distribuerar ett Kubernetes-kluster i Azure.

Distribuera Kubernetes-kluster