Esercitazione: Creare un registro Azure Container ed eseguire il push di un'immagine del contenitore

Questo articolo è la seconda parte di un'esercitazione in tre parti. Nella prima parte dell'esercitazione è stata creata un'immagine del contenitore Docker per un'applicazione Web Node.js. In questa esercitazione si esegue il push dell'immagine in Registro Azure Container. Se è necessario creare l'immagine del contenitore, tornare all'esercitazione 1 - Creare un'immagine del contenitore.

Registro Azure Container è il registro Docker privato in Azure. In questa esercitazione, la seconda della serie, vengono illustrate le attività seguenti:

Nell'articolo successivo, che corrisponde all'ultimo della serie, il contenitore viene distribuito dal registro privato a Istanze di Azure Container.

Operazioni preliminari

Per completare questa esercitazione, è necessario soddisfare i requisiti seguenti:

Interfaccia della riga di comando di Azure: è necessario che nel computer locale sia installata la versione 2.0.29 o successiva dell'interfaccia della riga di comando di Azure. Per trovare la versione, eseguire az --version. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

Docker: questa esercitazione presuppone una conoscenza di base dei concetti principali di Docker, come contenitori, immagini dei contenitore e comandi essenziali di docker. Per una panoramica dei concetti fondamentali relativi a Docker e ai contenitori, vedere Docker overview (Panoramica di Docker).

Docker: per completare questa esercitazione, è necessario aver installato Docker localmente. Docker offre pacchetti per la configurazione dell'ambiente Docker in macOS, Windows e Linux.

Creare un'istanza di Registro Azure Container

Prima di creare il registro contenitori, è necessario un gruppo di risorse in cui eseguirne la distribuzione. Un gruppo di risorse è una raccolta logica in cui vengono distribuite e gestite tutte le risorse di Azure.

Creare un gruppo di risorse con il comando az group create. Nell'esempio seguente viene creato un gruppo di risorse denominato myResourceGroup nell'area eastus:

az group create --name myResourceGroup --location eastus

Dopo aver creato il gruppo di risorse, creare un registro Azure Container con il comando az acr create . Il nome del registro contenitori deve essere univoco in Azure e contenere da 5 a 50 caratteri alfanumerici. Sostituire <acrName> con un nome univoco per il registro:

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

Ecco l'output parziale per una nuova istanza di Registro Azure Container denominata mycontainerregistry082:

{
  "creationDate": "2020-07-16T21:54:47.297875+00:00",
  "id": "/subscriptions/<Subscription ID>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/mycontainerregistry082",
  "location": "eastus",
  "loginServer": "mycontainerregistry082.azurecr.io",
  "name": "mycontainerregistry082",
  "provisioningState": "Succeeded",
  "resourceGroup": "myResourceGroup",
  "sku": {
    "name": "Basic",
    "tier": "Basic"
  },
  "status": null,
  "storageAccount": null,
  "tags": {},
  "type": "Microsoft.ContainerRegistry/registries"
}

Nel resto dell'esercitazione viene usato <acrName> come segnaposto per il nome del registro contenitori scelto in questo passaggio.

Accedere al registro contenitori

È necessario accedere all'istanza di Registro Azure Container prima di eseguire il push delle immagini. Usare il comando az acr login per completare l'operazione. È necessario specificare il nome univoco scelto per il registro contenitori al momento della creazione.

az acr login --name <acrName>

Ad esempio:

az acr login --name mycontainerregistry082

Al termine, il comando restituisce Login Succeeded:

Login Succeeded

Assegnare tag all'immagine del contenitore

Per eseguire il push di un'immagine del contenitore in un registro privato come Registro Azure Container, è prima necessario assegnare all'immagine un tag con il nome completo del server di accesso del registro.

Per prima cosa, ottenere il nome completo del server di accesso dell'istanza di Registro Azure Container. Eseguire il comando az acr show seguente e sostituire <acrName> con il nome del Registro di sistema creato:

az acr show --name <acrName> --query loginServer --output table

Se il nome del registro è mycontainerregistry082, ad esempio:

az acr show --name mycontainerregistry082 --query loginServer --output table

Result
------------------------
mycontainerregistry082.azurecr.io

Visualizzare quindi l'elenco delle immagini locali con il comando docker images:

docker images

Insieme a tutte le altre immagini presenti nel computer, verrà visualizzata l'immagine aci-tutorial-app creata nell'esercitazione precedente:

docker images

REPOSITORY          TAG       IMAGE ID        CREATED           SIZE
aci-tutorial-app    latest    5c745774dfa9    39 minutes ago    68.1 MB

Applicare all'immagine aci-tutorial-app il tag del server di accesso del registro contenitori. Aggiungere anche il tag :v1 alla fine del nome dell'immagine per indicarne il numero di versione. Sostituire <acrLoginServer> con il risultato del comando az acr show eseguito in precedenza.

docker tag aci-tutorial-app <acrLoginServer>/aci-tutorial-app:v1

Eseguire di nuovo docker images per verificare l'operazione di assegnazione di tag:

docker images

REPOSITORY                                            TAG       IMAGE ID        CREATED           SIZE
aci-tutorial-app                                      latest    5c745774dfa9    39 minutes ago    68.1 MB
mycontainerregistry082.azurecr.io/aci-tutorial-app    v1        5c745774dfa9    7 minutes ago     68.1 MB

Eseguire il push dell'immagine in Registro Azure Container

Ora che è stata contrassegnata l'immagine aci-tutorial-app con il nome completo del server di accesso del registro privato, è possibile eseguire il push dell'immagine nel registro con il comando docker push . Sostituire <acrLoginServer> con il nome completo del server di accesso ottenuto nel passaggio precedente.

docker push <acrLoginServer>/aci-tutorial-app:v1

L'operazione push richiede alcuni secondi a seconda della connessione Internet e l'output è simile all'esempio seguente:

docker push mycontainerregistry082.azurecr.io/aci-tutorial-app:v1

The push refers to a repository [mycontainerregistry082.azurecr.io/aci-tutorial-app]
3db9cac20d49: Pushed
13f653351004: Pushed
4cd158165f4d: Pushed
d8fbd47558a8: Pushed
44ab46125c35: Pushed
5bef08742407: Pushed
v1: digest: sha256:ed67fff971da47175856505585dcd92d1270c3b37543e8afd46014d328f05715 size: 1576

Elencare le immagini in Registro Azure Container

Per verificare che l'immagine di cui è appena stato eseguito il push si trovi effettivamente nell'istanza di Registro Azure Container, visualizzare l'elenco delle immagini nel registro con il comando az acr repository list. Sostituire <acrName> con il nome del registro contenitori.

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

Ad esempio:

az acr repository list --name mycontainerregistry082 --output table

Result
----------------
aci-tutorial-app

Per visualizzare i tag per un'immagine specifica, usare il comando az acr repository show-tags.

az acr repository show-tags --name <acrName> --repository aci-tutorial-app --output table

L'output dovrebbe essere simile all'esempio seguente:

--------
v1

Passaggi successivi

In questa esercitazione è stata preparata un'istanza di Registro Azure Container da usare con Istanze di Azure Container ed è stato eseguito il push di un'immagine del contenitore nel registro. Sono stati completati i passaggi seguenti:

Passare all'esercitazione successiva per apprendere come distribuire il contenitore in Azure usando Istanze di Azure Container: