Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker

È possibile usare Docker per eseguire un contenitore Linux autonomo con l'interfaccia della riga di comando di Azure preinstallata, fornendo un ambiente rapido e isolato per l'uso dell'interfaccia della riga di comando di Azure. Questa immagine del contenitore può fungere anche da base per le distribuzioni personalizzate.

Avvertimento

Azure CLI 2.63.0 (rilasciata ad agosto 2024) è l'ultima versione supportata sull'immagine Docker basata su Alpine. Microsoft non fornisce più aggiornamenti o correzioni di bug per questa immagine. Per garantire il supporto continuo, eseguire la migrazione all'immagine basata su Linux di Azure (Azure Linux 3.0), completamente gestita. Vedere gli esempi seguenti per l'uso di Azure Linux 3.0.

Per eliminare i messaggi di avviso, eseguire: az config set core.only_show_errors=yes. Per informazioni dettagliate sulle opzioni di configurazione, vedere Valori di configurazione dell'interfaccia della riga di comando di Azure e variabili di ambiente.

Avviare il contenitore Docker con l'interfaccia della riga di comando di Azure preinstallata

Aprire un prompt dei comandi e avviare un contenitore Docker con l'interfaccia della riga di comando di Azure preinstallata usando il comando seguente. Quando si usa questo comando in una pipeline, usare un tag deterministico (ad esempio azurelinux3.0) per garantire un comportamento coerente.

docker run -it mcr.microsoft.com/azure-cli:azurelinux3.0

Annotazioni

Per usare le chiavi SSH locali all'interno del contenitore, montare la directory .ssh includendo l'opzione seguente: --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh. Questa opzione consente al contenitore di accedere alle chiavi SSH dall'ambiente utente.

docker run -it --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh mcr.microsoft.com/azure-cli:azurelinux3.0

L'Azure CLI è disponibile nell'immagine come comando az, situato in /usr/local/bin/az.

Eseguire il contenitore Docker con una versione specifica dell'interfaccia della riga di comando di Azure

Puoi trovare le versioni disponibili nelle note sulla versione di Azure CLI.

Per eseguire una versione specifica dell'interfaccia della riga di comando di Azure in un contenitore Docker, usare il comando seguente, sostituendo 2.74.0 con la versione desiderata.

docker run -it mcr.microsoft.com/azure-cli:2.74.0-azurelinux3.0

Aggiornare l'immagine Docker

Per aggiornare l'interfaccia della riga di comando di Azure quando si usa Docker, è necessario eseguire il pull dell'immagine più recente e ricreare tutti i contenitori esistenti. A causa di questo processo di aggiornamento, evitare di usare i contenitori dell'interfaccia della riga di comando di Azure come archivi dati permanenti.

Aggiornare l'immagine locale usando il comando seguente:

docker pull mcr.microsoft.com/azure-cli:latest

Disinstallare l'immagine Docker

Se decidi di disinstallare l'interfaccia della riga di comando di Azure, ci dispiace vederti andare via. Prima di eseguire la disinstallazione, usare il comando az feedback per segnalare aspetti da migliorare o correggere. L'obiettivo è realizzare un'interfaccia della riga di comando di Azure priva di bug e facile da usare. Se hai trovato un bug, ti saremmo grati se tu potessi segnalare un problema su GitHub.

Per rimuovere l'immagine Docker, prima di tutto arrestare i contenitori in esecuzione, quindi eseguire:

docker rmi mcr.microsoft.com/azure-cli

Passaggi successivi

Ora che si è pronti per usare l'interfaccia della riga di comando di Azure in un contenitore Docker, vedere una breve panoramica delle funzionalità principali e dei comandi di uso comune per iniziare.

Introduzione all'interfaccia della riga di comando di Azure