Esercitazione: Creare un Registro Azure Container per il servizio Azure Kubernetes abilitato da Arc

Si applica a: Servizio Azure Kubernetes in Azure Stack HCI 22H2, servizio Azure Kubernetes in Windows Server

Un Registro Azure Container è un registro privato per le immagini del contenitore. Un registro contenitori privato consente di compilare e distribuire le applicazioni e il codice personalizzato in modo sicuro.

In questa esercitazione, parte due di sette, si distribuisce un'istanza Registro Azure Container e si esegue il push di un'immagine del contenitore per l'uso nel servizio Azure Kubernetes. Si apprenderà come:

  • Creare un'istanza di Registro Azure Container
  • Contrassegna un'immagine del contenitore per Registro Azure Container
  • Caricare l'immagine in Registro Azure Container
  • Visualizzare le immagini nel registro

Nelle esercitazioni successive, questa istanza di Registro Azure Container è integrata con un cluster Kubernetes e un'applicazione viene distribuita dall'immagine.

Prima di iniziare

L'esercitazione precedente descrive come creare un'immagine del contenitore per un'applicazione di voto di Azure semplice. Se l'immagine dell'app Azure Vote non è stata creata, tornare all'Esercitazione 1 - Creare immagini del contenitore.

Questa esercitazione richiede l'esecuzione dell'interfaccia della riga di comando di Azure versione 2.0.53 o successiva. Eseguire az --version per trovare la versione. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

Creare un'istanza di Registro Azure Container

Per creare un'istanza di Registro Azure Container, è prima necessario un gruppo di risorse. Un gruppo di risorse di Azure è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite.

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

Creare un'istanza di Registro Azure Container con il comando az acr create e specificare il nome del registro. Il nome del registro deve essere univoco in Azure e contenere da 5 a 50 caratteri alfanumerici. Nella parte restante di questa esercitazione viene usato <acrName> come segnaposto per il nome del registro contenitori. Specificare un nome di registro univoco. Lo SKU Basic è un punto di ingresso con costi ottimali a fini di sviluppo, che assicura l'equilibrio tra spazio di archiviazione e velocità effettiva.

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

Accedere al registro contenitori

Per usare l'istanza di Registro Azure Container, prima è necessario accedere. Usare il comando az acr login e specificare il nome univoco assegnato al Registro contenitori nel passaggio precedente:

az acr login --name <acrName>

Il comando restituisce un messaggio Login Successed al termine.

Contrassegnare un'immagine del contenitore

Per visualizzare un elenco delle immagini locali correnti, usare il comando docker images:

docker images

L'output del comando mostra un elenco delle immagini locali correnti:

REPOSITORY                                     TAG                 IMAGE ID            CREATED             SIZE
mcr.microsoft.com/azuredocs/azure-vote-front   v1                  84b41c268ad9        7 minutes ago       944MB
mcr.microsoft.com/oss/bitnami/redis            6.0.8               3a54a920bb6c        2 days ago          103MB
tiangolo/uwsgi-nginx-flask                     python3.6           a16ce562e863        6 weeks ago         944MB

Per usare l'immagine del contenitore azure-vote-front con Registro Azure Container, assicurarsi di contrassegnare l'immagine con l'indirizzo del server di accesso del Registro di sistema. Questo tag viene usato per il routing quando si esegue il push delle immagini del contenitore nel registro delle immagini.

Per ottenere l'indirizzo del server di accesso, usare il comando az acr list e cercare loginServer:

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

Contrassegnare ora l'immagine azure-vote-front locale con l'indirizzo acrLoginServer del registro contenitori. Per indicare la versione dell'immagine, aggiungere :v1 alla fine del nome dell'immagine:

docker tag mcr.microsoft.com/azuredocs/azure-vote-front:v1 <acrLoginServer>/azure-vote-front:v1

Per verificare che i tag vengano applicati, eseguire di nuovo immagini docker :

docker images

Un'immagine viene contrassegnata con l'indirizzo dell'istanza di Registro Azure Container e un numero di versione:

REPOSITORY                                      TAG                 IMAGE ID            CREATED             SIZE
mcr.microsoft.com/azuredocs/azure-vote-front    v1                  84b41c268ad9        16 minutes ago      944MB
mycontainerregistry.azurecr.io/azure-vote-front v1                  84b41c268ad9        16 minutes ago      944MB
mcr.microsoft.com/oss/bitnami/redis             6.0.8               3a54a920bb6c        2 days ago          103MB
tiangolo/uwsgi-nginx-flask                      python3.6           a16ce562e863        6 weeks ago         944MB

Eseguire il push delle immagini nel registro

Con l'immagine compilata e contrassegnata, eseguire il push dell'immagine di azure-vote-front nell'istanza di Registro Azure Container. Usare il push docker e specificare il proprio acrLoginServer indirizzo per il nome dell'immagine come indicato di seguito:

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

Potrebbe richiedere alcuni minuti per completare il push dell'immagine in Registro Azure Container.

Elencare le immagini nel registro

Per restituire un elenco di immagini push nell'istanza di Registro Azure Container, usare il comando az acr repository list. Immettere il valore <acrName> personalizzato come di seguito:

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

L'output di esempio seguente elenca l'immagine azure-vote-front disponibile nel registro:

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

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

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

L'esempio di output seguente mostra l'immagine v1 contrassegnata in un passaggio precedente:

Result
--------
v1

È ora disponibile un'immagine del contenitore archiviata in un'istanza privata di Registro Azure Container. Questa immagine viene distribuita da Registro Azure Container a un cluster Kubernetes nell'esercitazione successiva.

Passaggi successivi

In questa esercitazione è stata creata una Registro Azure Container e è stata eseguito il push di un'immagine da usare in un cluster Kubernetes. Si è appreso come:

  • Creare un'istanza di Registro Azure Container
  • Assegnare tag a un'immagine del contenitore per Registro Azure Container
  • Caricare l'immagine in Registro Azure Container
  • Visualizzare le immagini nel registro

Passare all'esercitazione successiva per informazioni su come distribuire un cluster Kubernetes in Azure.