Esaminare le operazioni del registro per la gestione delle immagini
Un registro Contenitori di Azure archivia e gestisce immagini di contenitori private e altri artefatti, analogamente al modo in cui l'hub Docker archivia le immagini dei contenitori Docker pubbliche. È possibile utilizzare l'interfaccia a riga di comando Docker (Docker CLI) per accedere, caricare, scaricare e gestire altre operazioni sulle immagini dei container nel registro dei container.
Prima di iniziare a gestire le immagini in un registro contenitori, configurare le risorse seguenti:
- Registro Azure Container: creare un registro contenitori nella sottoscrizione di Azure. Ad esempio, usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell.
- Interfaccia della riga di comando di Azure: è necessario aver installato l'interfaccia della riga di comando di Azure in locale. L'interfaccia della riga di comando di Azure può semplificare le attività ripetitive.
- Interfaccia della riga di comando di Docker: è necessario che Docker Desktop sia installato in locale. Docker Desktop consente di creare ed eseguire il push di immagini in base a un repository di codice. Docker fornisce pacchetti che configurano facilmente Docker in qualsiasi sistema macOS, Windows o Linux.
Accedere al Registro di sistema usando l'interfaccia della riga di comando di Azure
È necessario accedere al Registro di sistema prima di eseguire il push e il pull delle immagini del contenitore. È possibile eseguire l'accesso usando un comando dell'interfaccia della riga di comando di Azure.
L'interfaccia della riga di comando di Azure è disponibile per l'installazione in ambienti Windows, macOS e Linux. Può anche essere eseguito in un contenitore Docker e in Azure Cloud Shell. La versione corrente dell'interfaccia della riga di comando di Azure è 2.53.0. Per trovare la versione installata e verificare se è necessario aggiornare, eseguire il comando az version.
Accedere ad Azure usando il comando az login. Usare la sottoscrizione di Azure associata al progetto contenitore.
Accedere al Registro di sistema usando il comando az acr login. Specificare solo il nome della risorsa del Registro di sistema durante l'accesso con l'interfaccia della riga di comando di Azure. Non usare il nome completo del server di login. Ad esempio, usare il comando seguente per accedere a un registro denominato mycontainerregistryapl2003.
az acr login --name mycontainerregistryapl2003
Il comando restituisce un messaggio "Login Succeeded" una volta completato.
Caricare l'immagine nel registro
Per eseguire il push di un'immagine in un registro Azure Container, è prima necessario avere un'immagine. Se non si dispone di immagini di contenitori locali, usare un comando docker pull per eseguire il pull di un'immagine pubblica esistente.
L'esempio seguente esegue il pull dell'immagine hello-world da un Registro Contenitori Microsoft pubblico al computer locale:
docker pull mcr.microsoft.com/hello-world
Prima di poter eseguire il push di un'immagine nel registro, è necessario contrassegnarla con il nome completo del server di accesso del Registro di sistema. Il nome del server di accesso è nel formato <registry-name>.azurecr.io (deve essere tutto in minuscolo), ad esempio mycontainerregistryapl2003.azurecr.io.
È possibile contrassegnare l'immagine usando il comando docker tag come indicato di seguito:
docker tag mcr.microsoft.com/hello-world mycontainerregistryapl2003.azurecr.io/hello-world:v1
In questo esempio viene creata un'immagine di destinazione tag (mycontainerregistryapl2003.azurecr.io/hello-world:v1) che fa riferimento all'immagine di origine (mcr.microsoft.com/hello-world).
Usare infine il comando docker push per eseguire il push dell'immagine locale nell'istanza del Registro di sistema. Nell'esempio seguente viene creato il repository hello-world contenente l'immagine hello-world:v1.
docker push mycontainerregistryapl2003.azurecr.io/hello-world:v1
Dopo aver eseguito il push dell'immagine nel registro contenitori, rimuovere l'immagine hello-world:v1 dall'ambiente Docker locale. Il comando docker rmi non rimuove l'immagine dal repository hello-world nel Registro Azure Container.
docker rmi mycontainerregistryapl2003.azurecr.io/hello-world:v1
Nel portale di Azure, per visualizzare l'immagine di cui è stato eseguito il push, aprire il registro dei contenitori e quindi selezionare Repository.
Eseguire il pull e rimuovere l'immagine del registro
Usare il comando docker pull per eseguire il pull dell'immagine dal registro al computer locale:
docker pull mycontainerregistryapl2003.azurecr.io/hello-world:v1
Per rimuovere le immagini dal registro Azure Container, è possibile usare il comando dell'interfaccia della riga di comando di Azure az acr repository delete. Ad esempio, il comando seguente elimina il manifesto a cui fa riferimento il tag hello-world:v1, tutti i dati di livello univoci e tutti gli altri tag che fanno riferimento al manifesto.
az acr repository delete --name mycontainerregistryapl2003 --image hello-world:v1