Snabbstart: Skapa ett privat containerregister med hjälp av Azure CLI

Azure Container Registry är en privat registertjänst för att skapa, lagra och hantera containeravbildningar och relaterade artefakter. I den här snabbstarten skapar du en Azure-containerregisterinstans med Azure CLI. Använd sedan Docker-kommandon för att skicka en containeravbildning till registret, och hämta och kör slutligen avbildningen från registret.

För den här snabbstarten krävs att du kör Azure CLI (version 2.0.55 eller senare rekommenderas). Kör az --version för att hitta versionen. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.

Du måste också ha Docker installerat lokalt. Docker innehåller paket som enkelt kan konfigurera Docker på ett macOS-, Windows- eller Linux-system.

Eftersom Azure Cloud Shell inte innehåller alla nödvändiga Docker-komponenter (dockerd-daemon), kan du inte använda Cloud Shell för denna snabbstart.

Skapa en resursgrupp

Skapa en resursgrupp med kommandot az group create. En Azure-resursgrupp är en logisk container där Azure-resurser distribueras och hanteras.

I följande exempel skapas en resursgrupp med namnet myResourceGroup i regionen eastus.

Azure CLI

az group create --name myResourceGroup --location eastus

Skapa ett containerregister

I den här snabbstarten skapar du ett Basic-register, vilket är ett kostnadsoptimerat alternativ för utvecklare som lär sig om Azure Container Registry. Mer information om tillgängliga tjänstnivåer finns i Tjänstnivåer för containerregister.

Skapa en ACR-instans med hjälp av kommandot az acr create. Registernamnet måste vara unikt i Azure och innehålla 5–50 alfanumeriska gemener. I följande exempel används mycontainerregistry . Uppdatera det här till ett unikt värde.

Azure CLI

az acr create --resource-group myResourceGroup \
  --name mycontainerregistry --sku Basic

När registret har skapats ser utdata ut ungefär så här:

JSON

{
  "adminUserEnabled": false,
  "creationDate": "2019-01-08T22:32:13.175925+00:00",
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/mycontainerregistry",
  "location": "eastus",
  "loginServer": "mycontainerregistry.azurecr.io",
  "name": "mycontainerregistry",
  "provisioningState": "Succeeded",
  "resourceGroup": "myResourceGroup",
  "sku": {
    "name": "Basic",
    "tier": "Basic"
  },
  "status": null,
  "storageAccount": null,
  "tags": {},
  "type": "Microsoft.ContainerRegistry/registries"
}

Anteckna loginServer i utdata, vilket är de fullständigt kvalificerade registernamnet (endast gemener). Under resten av den här snabbstarten <registry-name> är en platshållare för containerregistrets namn och <login-server> är en platshållare för registrets inloggningsservernamn.

Tips

I den här snabbstarten skapar du ett Basic-register , vilket är ett kostnadsoptimerad alternativ för utvecklare som lär sig mer om Azure Container Registry. Välj andra nivåer för ökat lagrings- och bilddataflöde och funktioner som anslutning med hjälp av en privat slutpunkt. Mer information om tillgängliga tjänstnivåer (SKU:er) finns i Tjänstnivåer för containerregister.

Logga in till registret

Innan du skickar och hämtar containeravbildningar måste du logga in i registret. Det gör du med hjälp av kommandot az acr login. Ange endast namnet på registerresursen när du loggar in med Azure CLI. Använd inte det fullständigt kvalificerade inloggningsservernamnet.

Azure CLI

az acr login --name <registry-name>

Exempel:

Azure CLI

az acr login --name mycontainerregistry

Kommandot returnerar meddelandet Login Succeeded när det har slutförts.

Push-överför avbildningen till registret

Innan du kan push-överföra en avbildning till Azure Container Registry måste du ha en avbildning. Om du ännu inte har några lokala containeravbildningar kör du följande docker pull-kommando för att hämta en befintlig offentlig avbildning. I det här exemplet hämtar du avbildningen hello-world från Microsoft Container Registry.

docker pull mcr.microsoft.com/hello-world

Innan du kan skicka en avbildning till registret måste du tagga den med det fullständigt kvalificerade namnet på registerinloggningsservern. Inloggningsservernamnet är i formatet registry-name.azurecr.io> (måste vara alla gemener), till exempel mycontainerregistry.azurecr.io.<

Tagga avbildningen med hjälp av kommandot docker tag. Ersätt <login-server> med namnet på inloggningsservern för ACR-instansen.

docker tag mcr.microsoft.com/hello-world <login-server>/hello-world:v1

Exempel:

docker tag mcr.microsoft.com/hello-world mycontainerregistry.azurecr.io/hello-world:v1

Slutligen använder du docker-push-överföring för att skicka avbildningen till registerinstansen. Ersätt <login-server> med inloggningsservernamnet för registerinstansen. Det här exemplet skapar lagringsplatsen hello-world, som innehåller hello-world:v1-avbildningen.

docker push <login-server>/hello-world:v1

När du har push-överfört avbildningen till containerregistret tar du bort hello-world:v1-avbildningen från den lokala Docker-miljön. (Observera att detta docker rmi-kommando inte tar bort avbildningen från hello-world-lagringsplatsen i Azure-containerregistret.)

docker rmi <login-server>/hello-world:v1

Visa lista över containeravbildningar

I följande exempel visas lagringsplatserna i ditt register:

Azure CLI

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

Utdata:

Result
----------------
hello-world

I följande exempel visas taggarna på hello-world-lagringsplatsen .

Azure CLI

az acr repository show-tags --name <registry-name> --repository hello-world --output table

Utdata:

Result
--------
v1

Köra en avbildning från registret

Nu kan du hämta och köra hello-world:v1-containeravbildningen från containerregistret med hjälp av docker run:

docker run <login-server>/hello-world:v1  

Exempel på utdata>

Unable to find image 'mycontainerregistry.azurecr.io/hello-world:v1' locally
v1: Pulling from hello-world
Digest: sha256:662dd8e65ef7ccf13f417962c2f77567d3b132f12c95909de6c85ac3c326a345
Status: Downloaded newer image for mycontainerregistry.azurecr.io/hello-world:v1

Hello from Docker!
This message shows that your installation appears to be working correctly.

[...]

Rensa resurser

När resursgruppen inte längre behövs kan du använda kommandot az group delete till att ta bort resursgruppen, containerregistret och containeravbildningarna som är lagrade där.

Azure CLI

az group delete --name myResourceGroup

Nästa steg

I den här snabbstarten skapade du ett Azure Container Registry med Azure CLI, push-överförde en containeravbildning till registret och hämtade och körde avbildningen från registret. Fortsätt till självstudien om Azure Container Registry om du vill titta närmare på ACR.

Självstudier för Azure Container Registry

Självstudier om Azure Container Registry Tasks