Distribuire e usare il Registro contenitori di AzureDeploy and use Azure Container Registry

Avviso

Si sta visualizzando la documentazione per la versione precedente del servizio contenitore di Azure.You are viewing documentation for the old version of the Azure Container Service. Il servizio contenitore di Azure è in fase di aggiornamento con l'aggiunta di nuove opzioni di distribuzione, funzionalità di gestione migliorate e vantaggi economici in Kubernetes in Azure.Azure Container Service (AKS) is being updated to add new deployment options, enhanced management capabilities, and cost benefit to Kubernetes on Azure. Per iniziare a usare tali funzionalità in anteprima, vedere AKS documentation (Documentazione del servizio contenitore di Azure).Visit the AKS documentation to start working with these preview features.

Il Registro contenitori di Azure è un registro privato basato su Azure per le immagini del contenitore Docker.Azure Container Registry (ACR) is an Azure-based, private registry, for Docker container images. Questa esercitazione, parte due di sette, illustra la distribuzione di un'istanza di Registro contenitori di Azure e il push di un'immagine del contenitore al suo interno.This tutorial, part two of seven, walks through deploying an Azure Container Registry instance, and pushing a container image to it. I passaggi completati comprendono:Steps completed include:

  • Distribuzione di un'istanza di Registro contenitori di AzureDeploying an Azure Container Registry (ACR) instance
  • Assegnazione di tag a un'immagine del contenitore per Registro contenitori di AzureTagging a container image for ACR
  • Caricamento dell'immagine in Registro contenitori di AzureUploading the image to ACR

Nelle esercitazioni successive, questa istanza del Registro contenitori di Azure viene integrata con un cluster Kubernetes del servizio contenitore di Azure.In subsequent tutorials, this ACR instance is integrated with an Azure Container Service Kubernetes cluster.

Prima di iniziareBefore you begin

Nell'esercitazione precedente è stata creta un'immagine del contenitore per una semplice applicazione Azure Voting.In the previous tutorial, a container image was created for a simple Azure Voting application. Se l'immagine dell'app Azure Vote non è stata creata, tornare all'Esercitazione 1 - Creare immagini del contenitore.If you have not created the Azure Voting app image, return to Tutorial 1 – Create container images.

Questa esercitazione richiede l'interfaccia della riga di comando di Azure 2.0.4 o versioni successive.This tutorial requires that you are running the Azure CLI version 2.0.4 or later. Eseguire az --version per trovare la versione.Run az --version to find the version. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure 2.0.If you need to install or upgrade, see Install Azure CLI 2.0.

Distribuire il Registro contenitori di AzureDeploy Azure Container Registry

Prima di distribuire un Registro contenitori di Azure, è necessario che esista un gruppo di risorse.When deploying an Azure Container Registry, you first need a resource group. Un gruppo di risorse di Azure è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite.An Azure resource group is a logical container into which Azure resources are deployed and managed.

Creare un gruppo di risorse con il comando az group create.Create a resource group with the az group create command. In questo esempio viene creato un gruppo di risorse denominato myResourceGroup nell'area westeurope.In this example, a resource group named myResourceGroup is created in the westeurope region.

az group create --name myResourceGroup --location westeurope

Creare un Registro contenitori di Azure con il comando az acr create.Create an Azure Container registry with the az acr create command. Il nome di un registro contenitori deve essere univoco.The name of a Container Registry must be unique.

az acr create --resource-group myResourceGroup --name <acrName> --sku Basic

Nella parte restante di questa esercitazione si usa <acrname> come segnaposto per il nome del registro contenitori.Throughout the rest of this tutorial, we use <acrname> as a placeholder for the container registry name.

Accesso al registro contenitoriContainer registry login

Usare il comando az acr login per accedere all'istanza del Registro contenitori di Azure.Use the az acr login command to log in to the ACR instance. È necessario specificare il nome univoco assegnato al registro contenitori al momento della creazione.You need to provide the unique name given to the container registry when it was created.

az acr login --name <acrName>

Al termine, il comando restituisce un messaggio di accesso riuscito.The command returns a 'Login Succeeded’ message once completed.

Assegnare tag alle immagini del contenitoreTag container images

Per visualizzare un elenco di immagini correnti, usare il comando docker images.To see a list of current images, use the docker images command.

docker images

Output:Output:

REPOSITORY                   TAG                 IMAGE ID            CREATED             SIZE
azure-vote-front             latest              4675398c9172        13 minutes ago      694MB
redis                        latest              a1b99da73d05        7 days ago          106MB
tiangolo/uwsgi-nginx-flask   flask               788ca94b2313        9 months ago        694MB

Ogni immagine del contenitore deve essere contrassegnata con il nome del server di accesso del registro.Each container image needs to be tagged with the loginServer name of the registry. Questo tag viene usato per il routing quando si esegue il push delle immagini del contenitore nel registro delle immagini.This tag is used for routing when pushing container images to an image registry.

Per ottenere il nome loginServer, eseguire questo comando.To get the loginServer name, run the following command.

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

Applicare ora il tag loginServer del registro contenitori all'immagine azure-vote-front.Now, tag the azure-vote-front image with the loginServer of the container registry. Aggiungere anche :redis-v1 alla fine del nome dell'immagine.Also, add :redis-v1 to the end of the image name. Questo tag indica la versione dell'immagine.This tag indicates the image version.

docker tag azure-vote-front <acrLoginServer>/azure-vote-front:redis-v1

Dopo aver assegnato il tag, eseguire docker images per verificare l'operazione.Once tagged, run docker images to verify the operation.

docker images

Output:Output:

REPOSITORY                                           TAG                 IMAGE ID            CREATED             SIZE
azure-vote-front                                     latest              eaf2b9c57e5e        8 minutes ago       716 MB
mycontainerregistry082.azurecr.io/azure-vote-front   redis-v1            eaf2b9c57e5e        8 minutes ago       716 MB
redis                                                latest              a1b99da73d05        7 days ago          106MB
tiangolo/uwsgi-nginx-flask                           flask               788ca94b2313        8 months ago        694 MB

Eseguire il push delle immagini nel registroPush images to registry

Eseguire il push dell'immagine azure-vote-front nel registro.Push the azure-vote-front image to the registry.

Nell'esempio seguente sostituire il nome del loginServer del Registro contenitori di Azure con il loginServer dell'ambiente in uso.Using the following example, replace the ACR loginServer name with the loginServer from your environment.

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

Il completamento dell'operazione richiede alcuni minuti.This takes a couple of minutes to complete.

Elencare le immagini nel registroList images in registry

Per restituire un elenco di immagini di cui è stato eseguito il push nel Registro contenitori di Azure, usare il comando az acr repository list.To return a list of images that have been pushed to your Azure Container registry, user the az acr repository list command. Aggiornare il comando con il nome dell'istanza del Registro contenitori di Azure.Update the command with the ACR instance name.

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

Output:Output:

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

Per visualizzare i tag per un'immagine specifica, usare il comando az acr repository show-tags.And then to see the tags for a specific image, use the az acr repository show-tags command.

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

Output:Output:

Result
--------
redis-v1

Al termine dell'esercitazione, l'immagine del contenitore sarà stata archiviata in un'istanza privata di Registro contenitori di Azure.At tutorial completion, the container image has been stored in a private Azure Container Registry instance. Questa immagine verrà distribuita da Registro contenitori di Azure a un cluster Kubernetes nelle esercitazioni successive.This image is deployed from ACR to a Kubernetes cluster in subsequent tutorials.

Passaggi successiviNext steps

In questa esercitazione un Registro contenitori di Azure è stato preparato per l'uso in un cluster Kubernetes del servizio contenitore di Azure.In this tutorial, an Azure Container Registry was prepared for use in an ACS Kubernetes cluster. Sono stati completati i passaggi seguenti:The following steps were completed:

  • Distribuzione di un'istanza di Registro contenitori di AzureDeployed an Azure Container Registry instance
  • Assegnazione di tag a un'immagine del contenitore per Registro contenitori di AzureTagged a container image for ACR
  • Caricamento dell'immagine in Registro contenitori di AzureUploaded the image to ACR

Passare all'esercitazione successiva per informazioni sulla distribuzione di un cluster Kubernetes in Azure.Advance to the next tutorial to learn about deploying a Kubernetes cluster in Azure.