Esercitazione: Creare un Registro Azure Container per il servizio Azure Kubernetes abilitato da Arc
Si applica a: AKS su Azure Locale 22H2, AKS su 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 2 di sette, si distribuisce un'istanza di 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.
Operazioni preliminari
L'esercitazione precedente descrive come creare un'immagine del contenitore per una semplice applicazione Azure Voting. Se l'immagine dell'app Azure Voting non è stata creata, tornare all'Esercitazione 1 - Creare immagini del contenitore.
Per questa esercitazione è necessario eseguire l'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 Registro Azure Container
Per creare un'istanza di Registro Azure Container, è necessario innanzitutto 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>
Al termine, il comando restituisce un messaggio Login Succeeded .
Contrassegnare un'immagine del contenitore
Per visualizzare un elenco delle immagini locali correnti, usare il comando docker images:
docker images
L'output di questo 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. 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 siano applicati, eseguire di nuovo le 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 azure-vote-front nell'istanza di Registro Azure Container. Usare docker push e specificare il proprio acrLoginServer
indirizzo per il nome dell'immagine come indicato di seguito:
docker push <acrLoginServer>/azure-vote-front:v1
Il push dell'immagine in Registro Azure Container potrebbe richiedere alcuni minuti.
Elencare le immagini nel registro
Per restituire un elenco di immagini di cui è stato eseguito il 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 è stato creato un Registro Azure Container ed è stato eseguito il push di un'immagine da usare in un cluster Kubernetes. Contenuto del modulo:
- 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.