Installare interfaccia della riga di comando di Azure in macOS

L'interfaccia Azure Command-Line è uno strumento da riga di comando multipiattaforma che può essere installato localmente nei computer macOS. È possibile usare il interfaccia della riga di comando di Azure per connettersi a Azure ed eseguire comandi amministrativi su Azure risorse usando prompt della riga di comando interattivi o uno script.

Per la piattaforma macOS, installare il interfaccia della riga di comando di Azure con gestione pacchetti homebrew. Homebrew semplifica il mantenimento aggiornato della interfaccia della riga di comando di Azure. Il pacchetto interfaccia della riga di comando di Azure richiede macOS 13 o versione successiva.

La versione corrente del interfaccia della riga di comando di Azure è 2.85.0. Per informazioni sull'ultima versione, vedere le note di rilascio . Per individuare la versione installata e verificare se è necessario aggiornarla, eseguire az version.

Installare con Homebrew

Homebrew è il modo più semplice per gestire l'installazione interfaccia della riga di comando di Azure. Permette di eseguire agevolmente le operazioni di installazione, aggiornamento e disinstallazione. Se Homebrew non è disponibile nel sistema, installare Homebrew prima di continuare.

È possibile installare il interfaccia della riga di comando di Azure in macOS aggiornando le informazioni del repository brew e quindi eseguendo il comando install:

brew update && brew install azure-cli

Risoluzione dei problemi

Se si verifica un problema durante l'installazione del interfaccia della riga di comando di Azure tramite Homebrew, ecco alcuni errori comuni. Se si verifica un problema non trattato qui, file un problema in GitHub.

Il completamento non funziona

La formula Homebrew di interfaccia della riga di comando di Azure installa un file di completamento denominato az nella directory dei completamenti gestiti da Homebrew (il percorso predefinito è /usr/local/etc/bash_completion.d/). Per abilitare il completamento, seguire le istruzioni di Homebrew qui.

Per Zsh, aggiungere le due righe seguenti alla fine del .zshrc file, quindi salvare e ricaricare il profilo Zsh.

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

Impossibile trovare Python o pacchetti installati

Potrebbe verificarsi un disallineamento della versione minore o un altro problema durante l'installazione di homebrew. Il interfaccia della riga di comando di Azure non usa un ambiente virtuale Python, quindi si basa sulla ricerca della versione Python installata. Una possibile soluzione è installare e ricollegare la dipendenza python@3.10 da Homebrew.

brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10

interfaccia della riga di comando di Azure versione 1.x è installato

Se è stata installata una versione obsoleta, è possibile che la cache di Homebrew non sia aggiornata. Seguire le istruzioni per l'aggiornamento.

Il proxy blocca la connessione

Potrebbe non essere possibile ottenere risorse da Homebrew a meno che non venga configurato per l'uso del proxy. Seguire le istruzioni per la configurazione del proxy di Homebrew.

Per ottenere le risorse bottle da Homebrew, il proxy deve consentire le connessioni HTTPS agli indirizzi seguenti:

• https://formulae.brew.sh
• https://homebrew.bintray.com

Aggiornamento

Il interfaccia della riga di comando di Azure viene aggiornato regolarmente con correzioni di bug, miglioramenti, nuove funzionalità e funzionalità di anteprima. Una nuova versione è disponibile circa una volta al mese.

A partire dalla versione 2.11.0, il interfaccia della riga di comando di Azure fornisce un comando in-tool per eseguire l'aggiornamento alla versione più recente.

az upgrade

Per impostazione predefinita, questo comando aggiorna anche tutte le estensioni installate. Per altre az upgrade opzioni, vedere la pagina di riferimento del comando. Per interfaccia della riga di comando di Azure versioni precedenti a 2.11.0, eseguire l'aggiornamento reinstallando come descritto in Installare il interfaccia della riga di comando di Azure.

È anche possibile aggiornare le informazioni del repository Homebrew locale e quindi aggiornare il pacchetto azure-cli.

brew update && brew upgrade azure-cli

Disinstallare

Se decidi di disinstallare 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 è quello di rendere l'interfaccia della riga di comando di Azure senza bug e facile da usare. Se è stato rilevato un bug, è consigliabile segnalare un problema di GitHub.

Usare Homebrew per disinstallare il pacchetto azure-cli.

brew uninstall azure-cli

Rimuovere i dati

Se non si prevede di reinstallare il interfaccia della riga di comando di Azure, rimuovere i relativi dati.

rm -rf ~/.azure

Altri metodi di installazione

Se non è possibile usare homebrew per installare il interfaccia della riga di comando di Azure nell'ambiente in uso, è possibile usare le istruzioni manuali per Linux. Questo processo non viene ufficialmente mantenuto per essere compatibile con macOS. È consigliabile usare uno strumento di gestione pacchetti come Homebrew. Usare il metodo di installazione manuale solo se non sono disponibili altre opzioni.

Per istruzioni sull'installazione manuale, vedere Installare manualmente interfaccia della riga di comando di Azure in Linux.

Passaggi successivi

Ora che è stato installato il interfaccia della riga di comando di Azure in macOS, esaminare brevemente le funzionalità e i comandi comuni.