Guida introduttiva: Creare un registro contenitori privato usando il portale di AzureQuickstart: Create a private container registry using the Azure portal

Un registro contenitori di Azure è un registro Docker privato in Azure nel quale è possibile archiviare e gestire le immagini del contenitore Docker privato.An Azure container registry is a private Docker registry in Azure where you can store and manage your private Docker container images. In questa guida introduttiva viene creato un registro contenitori di Azure con il portale di Azure.In this quickstart, you create a container registry with the Azure portal. Usare quindi i comandi di Docker per eseguire il push di un'immagine del contenitore nel registro e infine eseguire il pull ed eseguire l'immagine dal registro.Then, use Docker commands to push a container image into the registry, and finally pull and run the image from your registry.

Per accedere al registro e usare immagini del contenitore, questa guida introduttiva richiede l'esecuzione dell'interfaccia della riga di comando di Azure (consigliata la versione 2.0.55 o successiva).To log in to the registry to work with container images, this quickstart requires that you are running the Azure CLI (version 2.0.55 or later recommended). 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.If you need to install or upgrade, see Install Azure CLI.

È anche necessario avere Docker installato localmente.You must also have Docker installed locally. Docker offre pacchetti che consentono di configurare facilmente Docker in qualsiasi sistema Mac, Windows o Linux.Docker provides packages that easily configure Docker on any Mac, Windows, or Linux system.

Accedere ad AzureSign in to Azure

Accedere al portale di Azure all'indirizzo https://portal.azure.com.Sign in to the Azure portal at https://portal.azure.com.

Creare un registro contenitoriCreate a container registry

Selezionare Crea una risorsa > Contenitori > Registro Container.Select Create a resource > Containers > Container Registry.

Creazione di un registro contenitori con il portale di Azure

Immettere i valori nei campi Nome registro e Gruppo di risorse.Enter values for Registry name and Resource group. Il nome del registro deve essere univoco in Azure e contenere da 5 a 50 caratteri alfanumerici.The registry name must be unique within Azure, and contain 5-50 alphanumeric characters. Per questa guida introduttiva creare un nuovo gruppo di risorse nella posizione West US denominata myResourceGroup e per SKU selezionare "Basic".For this quickstart create a new resource group in the West US location named myResourceGroup, and for SKU, select 'Basic'. Selezionare Crea per distribuire l'istanza del record di controllo di accesso.Select Create to deploy the ACR instance.

Creare il registro contenitori nel portale di Azure

In questa guida introduttiva viene creato un registro Basic, ovvero un'opzione ottimizzata in termini di costo per sviluppatori che iniziano a usare Registro Azure Container.In this quickstart you create a Basic registry, which is a cost-optimized option for developers learning about Azure Container Registry. Per informazioni dettagliate sui livelli di servizio disponibili, vedere SKU di Registro Azure Container.For details on available service tiers, see Container registry SKUs.

Quando viene visualizzato il messaggio La distribuzione è riuscita, selezionare il registro contenitori nel portale.When the Deployment succeeded message appears, select the container registry in the portal.

Panoramica del registro contenitori nel portale di Azure

Prendere nota del valore indicato in Server di accesso.Take note of the value of the Login server. Questo valore servirà nei passaggi seguenti quando si usa il registro con l'interfaccia della riga di comando di Azure e Docker.You use this value in the following steps while working with your registry with the Azure CLI and Docker.

Accedere al registroLog in to registry

Prima di eseguire il push e il pull delle immagini del contenitore, è necessario accedere all'istanza di Registro Azure Container.Before pushing and pulling container images, you must log in to the ACR instance. Aprire una shell dei comandi nel sistema operativo e usare il comando az acr login nell'interfaccia della riga di comando di Azure.Open a command shell in your operating system, and use the az acr login command in the Azure CLI.

az acr login --name <acrName>

Il comando restituisce Login Succeeded al termine dell'esecuzione.The command returns Login Succeeded once completed.

Eseguire il push dell'immagine nel registroPush image to registry

Per eseguire il push di un'immagine in Registro Azure Container è necessario innanzitutto disporre di un'immagine.To push an image to an Azure Container registry, you must first have an image. Se non sono ancora disponibili immagini del contenitore locale, eseguire il comando seguente docker pull per eseguire il pull di un'immagine esistente da Hub Docker.If you don't yet have any local container images, run the following docker pull command to pull an existing image from Docker Hub. Per questo esempio, eseguire il pull dell'immagine hello-world.For this example, pull the hello-world image.

docker pull hello-world

Prima di poter eseguire il push di un'immagine nel registro, è necessario contrassegnarla con il nome completo del server di accesso del record di controllo di accesso.Before you can push an image to your registry, you must tag it with the fully qualified name of your ACR login server. Il nome del server di accesso è nel formato <registry-name>.azurecr.io (tutto in minuscolo), ad esempio mycontainerregistry007.azurecr.io.The login server name is in the format <registry-name>.azurecr.io (all lowercase), for example, mycontainerregistry007.azurecr.io.

Contrassegnare l'immagine usando il comando docker tag.Tag the image using the docker tag command. Sostituire <acrLoginServer> con il nome del server di accesso dell'istanza del record di controllo di accesso.Replace <acrLoginServer> with the login server name of your ACR instance.

docker tag hello-world <acrLoginServer>/hello-world:v1

Infine, usare docker push per eseguire il push dell'immagine nell'istanza del record di controllo di accesso.Finally, use docker push to push the image to the ACR instance. Sostituire <acrLoginServer> con il nome del server di accesso dell'istanza del record di controllo di accesso.Replace <acrLoginServer> with the login server name of your ACR instance. Questo esempio crea il repository hello-world che contiene l'immagine hello-world:v1.This example creates the hello-world repository, containing the hello-world:v1 image.

docker push <acrLoginServer>/hello-world:v1

Dopo il push dell'immagine nel registro contenitori, rimuovere l'immagine hello-world:v1 dall'ambiente Docker locale.After pushing the image to your container registry, remove the hello-world:v1 image from your local Docker environment. Si noti che questo comando docker rmi non rimuove l'immagine dal repository hello-world nel registro contenitori di Azure.(Note that this docker rmi command does not remove the image from the hello-world repository in your Azure container registry.)

docker rmi <acrLoginServer>/hello-world:v1

Elencare le immagini del contenitoreList container images

Per elencare le immagini presenti nel registro, passare al registro nel portale e scegliere Repository, quindi selezionare il repository creato con docker push.To list the images in your registry, navigate to your registry in the portal and select Repositories, then select the repository you created with docker push.

In questo esempio è stato selezionato il repository busybox ed è possibile vedere l'immagine contraddistinta dal tag v1 in TAGS.In this example, we select the busybox repository, and we can see the v1-tagged image under TAGS.

Elencare le immagini del contenitore nel portale di Azure

Eseguire un'immagine dal registroRun image from registry

È possibile ora effettuare il pull ed eseguire l'immagine del contenitore hello-world:v1 dal registro contenitori usando docker run:Now, you can pull and run the hello-world:v1 container image from your container registry by using docker run:

docker run <acrLoginServer>/hello-world:v1  

Output di esempio:Example output:

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

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

[...]

Pulire le risorseClean up resources

Per pulire le risorse, passare al gruppo di risorse myResourceGroup nel portale.To clean up your resources, navigate to the myResourceGroup resource group in the portal. Dopo aver caricato il gruppo di risorse, fare clic su Elimina gruppo di risorse per rimuovere il gruppo di risorse, il registro contenitori e le immagini del contenitore archiviate nel registro.Once the resource group is loaded click on Delete resource group to remove the resource group, the container registry, and the container images stored there.

Eliminare il gruppo di risorse nel portale di Azure

Passaggi successiviNext steps

In questa guida introduttiva è stata creata un'istanza di Registro Azure Container con il portale di Azure, è stato eseguito il push di un'immagine del contenitore e quindi è stato eseguito il pull per eseguire l'immagine dal registro.In this quickstart, you created an Azure Container Registry with the Azure portal, pushed a container image, and pulled and ran the image from the registry. Per maggiori informazioni su Registro Azure Container, passare alle relative esercitazioni.Continue to the Azure Container Registry tutorials for a deeper look at ACR.