Avvio rapido: Creare un registro contenitori con il portale di AzureQuickstart: Create a 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 si crea un registro contenitori con il portale di Azure, si esegue il push di un'immagine del contenitore nel registro e infine si distribuisce il contenitore dal registro a Istanze di contenitore di Azure.In this quickstart, you create a container registry with the Azure portal, push a container image into the registry and finally deploy the container from your registry into Azure Container Instances (ACI).

Per completare questa Guida introduttiva, è necessario che Docker sia installato in locale.To complete this quickstart, you must 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 di contenitoriCreate a container registry

Selezionare Crea una risorsa > Contenitori > Registro contenitori di Azure.Select Create a resource > Containers > Azure 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. Creare un nuovo gruppo di risorse denominato myResourceGroup e selezionare 'Basic' per SKU.Create a new resource group 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.

Creazione di un registro contenitori con il portale di Azure

In questa guida introduttiva viene creato un registro contenitori di base.In this quickstart, we create a Basic registry. Registro contenitori di Azure è disponibile in diversi SKU, descritti brevemente nella tabella riportata di seguito.Azure Container Registry is available in several different SKUs, described briefly in the following table. Per altri dettagli su ogni SKU, vedere SKU di Registro contenitori.For extended details on each, see Container registry SKUs.

SKUSKU DESCRIZIONEDescription
BasicBasic Un punto di ingresso di ottimizzazione dei costi per gli sviluppatori che iniziano a usare Registro contenitori di Azure.A cost-optimized entry point for developers learning about Azure Container Registry. I registri Basic dispongono delle stesse funzionalità programmatiche del livello Standard e Premium, ovvero l'integrazione dell'autenticazione, l'eliminazione di immagini e gli hook Web di Azure Active Directory, tuttavia ci sono limiti di dimensioni e uso.Basic registries have the same programmatic capabilities as Standard and Premium (Azure Active Directory authentication integration, image deletion, and web hooks), however, there are size and usage constraints.
StandardStandard Il registro Standard offre le stesse funzionalità del livello Basic, ma con limiti di archiviazione e velocità effettiva di immagine aumentati.The Standard registry offers the same capabilities as Basic, but with increased storage limits and image throughput. I registri Standard devono soddisfare le esigenze della maggior parte degli scenari di produzione.Standard registries should satisfy the needs of most production scenarios.
PremiumPremium I registri Premium hanno limiti più elevati sui vincoli, ad esempio le operazioni di archiviazione o simultanee, tra cui le migliorate funzionalità di archiviazione per supportare scenari con volumi elevati.Premium registries have higher limits on constraints, such as storage and concurrent operations, including enhanced storage capabilities to support high-volume scenarios. Oltre alla maggiore capacità di velocità effettiva per le immagini, il livello Premium aggiunge funzionalità come la replica geografica per la gestione di un solo registro in più aree, mantenendo un registro in una posizione di rete vicina a ogni distribuzione.In addition to higher image throughput capacity, Premium adds features like geo-replication for managing a single registry across multiple regions, maintaining a network-close registry to each deployment.

Quando viene visualizzato il messaggio La distribuzione è riuscita, selezionare il registro contenitori nel portale, quindi selezionare le chiavi di accesso.When the Deployment succeeded message appears, select the container registry in the portal, then select Access keys.

Creazione di un registro contenitori con il portale di Azure

In Utente amministratoreselezionare Abilita.Under Admin user, select Enable. Annotare i valori seguenti:Take note of the following values:

  • Server di accessoLogin server
  • UsernameUsername
  • passwordpassword

Questi valori vengono usati nei passaggi seguenti quando si usa il registro con l'interfaccia della riga di comando Docker.You use these values in the following steps while working with your registry with the Docker CLI.

Creazione di un registro contenitori con il portale di Azure

Accedere al record di controllo di accessoLog in to ACR

Prima di eseguire il push e il pull delle immagini del contenitore, è necessario accedere all'istanza di Registro contenitori di Azure.Before pushing and pulling container images, you must log in to the ACR instance. A tale scopo usare il comando docker login.To do so, use the docker login command. Sostituire i valori di username, password e del login server con quelli annotati nel passaggio precedente.Replace the username, password, and login server values with those you noted in the previous step.

docker login --username <username> --password <password> <login server>

Il comando restituisce Login Succeeded al termine dell'esecuzione.The command returns Login Succeeded once completed. È possibile visualizzare un avviso di sicurezza in cui si consiglia l'uso del parametro --password-stdin.You might also see a security warning recommending the use of the --password-stdin parameter. Sebbene il suo utilizzo non rientri nell'ambito di questo articolo, si raccomanda di seguire questa procedura consigliata.While its use is outside the scope of this article, we recommend following this best practice. Per altri dettagli, vedere le informazioni di riferimento sul comando docker login.See the docker login command reference for more information.

Eseguire il push di un'immagine nel record di controllo di accessoPush image to ACR

Per eseguire il push di un'immagine nel Registro contenitori di Azure è necessario innanzitutto disporre di un'immagine.To push an image to your Azure Container Registry, you must first have an image. Se necessario, eseguire il comando seguente per eseguire il pull di un'immagine esistente dall'Hub Docker.If needed, run the following command to pull an existing image from Docker Hub.

docker pull microsoft/aci-helloworld

Prima di eseguire il push dell'immagine nel registro, è necessario contrassegnare l'immagine con il nome del server di accesso al record di controllo di accesso.Before you push the image to your registry, you must tag the image with the ACR login server name. Contrassegnare l'immagine usando il comando docker tag.Tag the image using the docker tag command. Sostituire login server con il nome del server di accesso registrato in precedenza.Replace login server with the login server name you recorded earlier.

docker tag microsoft/aci-helloworld <login server>/aci-helloworld: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 login server con il nome del server di accesso dell'istanza del record di controllo di accesso.Replace login server with the login server name of your ACR instance.

docker push <login server>/aci-helloworld:v1

L'output di comando docker push corretto è simile al seguente:Output from a successful docker push command is similar to:

The push refers to a repository [uniqueregistryname.azurecr.io/aci-helloworld]
7c701b1aeecd: Pushed
c4332f071aa2: Pushed
0607e25cc175: Pushed
d8fbd47558a8: Pushed
44ab46125c35: Pushed
5bef08742407: Pushed
v1: digest: sha256:f2867748615cc327d31c68b1172cc03c0544432717c4d2ba2c1c2d34b18c62ba size: 1577

Elencare le immagini del contenitoreList container images

Per elencare le immagini nell'istanza del record di controllo di accesso, passare al registro nel portale e scegliere Repository, quindi selezionare il repository creato con docker push.To list the images in your ACR instance, navigate to your registry in the portal and select Repositories, then select the repository you created with docker push.

In questo esempio è stato selezionano il repository aci-helloworld ed è possibile vedere l'immagine v1 contrassegnata in TAGS.In this example, we select the aci-helloworld repository, and we can see the v1-tagged image under TAGS.

Creazione di un registro contenitori con il portale di Azure

Distribuire l'immagine in Istanze di contenitore di AzureDeploy image to ACI

Per distribuire in un'istanza dal registro è necessario passare al repository (aci-helloworld) e quindi fare clic sui puntini di sospensione accanto a v1.In order to deploy to an instance from the registry we need to navigate to the repository (aci-helloworld), and then click on the ellipsis next to v1.

Avvio di un'istanza di contenitore di Azure dal portale

Verrà visualizzato un menu di scelta rapida. Scegliere Esegui istanza:A context menu will appear, select Run instance:

Menu di scelta rapida di avvio dell'istanza di contenitore di Azure

Compilare il campo Nome contenitore, verificare che sia selezionata la sottoscrizione corretta, selezionare il gruppo di risorse "myResourceGroup" esistente e quindi fare clic su OK per avviare l'istanza di contenitore di Azure.Fill in Container name, ensure the correct subscription is selected, select the existing Resource group: "myResourceGroup" and then click OK to launch the Azure Container Instance.

Opzioni di distribuzione per l'avvio dell'istanza di contenitore di Azure

All'avvio della distribuzione, nel dashboard del portale viene inserito un riquadro che indica lo stato della distribuzione.When deployment starts a tile is placed on your portal dashboard indicating deployment progress. Dopo aver completato la distribuzione, il riquadro viene aggiornato per mostrare il nuovo gruppo di contenitori mycontainer.Once deployment completes, the tile is updated to show your new mycontainer container group.

Stato della distribuzione dell'istanza di contenitore di Azure

Selezionare il gruppo di contenitori mycontainer per visualizzarne le proprietà.Select the mycontainer container group to display the container group properties. Prendere nota dell'indirizzo IP del gruppo di contenitori e dello STATO del contenitore.Take note of the IP address of the container group, as well as the STATUS of the container.

Dettagli del contenitore dell'istanza di contenitore di Azure

Visualizzare l'applicazioneView the application

Quando il contenitore si trova nello stato In esecuzione, usare un browser a scelta per passare all'indirizzo IP annotato nel passaggio precedente per visualizzare l'applicazione.Once the container is in the Running state, use your favorite browser to navigate to the IP address you noted in the previous step to display the application.

App Hello World nel browser

Pulire le risorseClean up resources

Per rimuovere 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 di Azure e tutte le istanze di contenitore di Azure.Once the resource group is loaded click on Delete resource group to remove the resource group, the Azure Container Registry, and all Azure Container Instances.

Creazione di un registro contenitori con il portale di Azure

Passaggi successiviNext steps

In questa guida introduttiva è stato creato un registro contenitori di Azure con l'interfaccia della riga di comando di Azure e ne è stata avviata un'istanza tramite Istanze di contenitore di Azure.In this quickstart, you created an Azure Container Registry with the Azure CLI, and launched an instance of it via Azure Container Instances. Passare all'esercitazione su Istanze di contenitore di Azure per maggiori informazioni.Continue to the Azure Container Instances tutorial for a deeper look at ACI.