Installare l'interfaccia della riga di comando di Azure in macOS

L'interfaccia della riga di comando di Azure (interfaccia della riga di comando) consente l'esecuzione di comandi tramite un terminale usando prompt della riga di comando interattivi o uno script. È possibile installare l'interfaccia della riga di comando di Azure in locale nei computer macOS. L'interfaccia della riga di comando di Azure in macOS consente l'esecuzione di vari comandi tramite un terminale usando prompt della riga di comando interattivi o uno script.

Per la piattaforma macOS, è possibile installare l'interfaccia della riga di comando di Azure con la gestione pacchetti Homebrew. Homebrew rende più semplice mantenere l'installazione dell'interfaccia della riga di comando sempre aggiornata. Il pacchetto dell'interfaccia della riga di comando è stato testato in macOS 10.9 e versioni successive.

La versione corrente dell'interfaccia della riga di comando di Azure è 2.63.0. Per informazioni sulla versione più recente, vedere le note sulla versione. Per individuare la versione installata e verificare se è necessario aggiornarla, eseguire az version.

Eseguire l'installazione con Homebrew

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

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

brew update && brew install azure-cli

Risoluzione dei problemi

Se si verifica un problema durante l'installazione dell'interfaccia della riga di comando con Homebrew, alcuni errori comuni sono i seguenti. Se si verifica un problema non trattato in questo articolo, segnalarlo in GitHub.

Il completamento non funziona

La formula Homebrew dell'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 i pacchetti installati

Potrebbe esserci una mancata corrispondenza tra le versioni oppure un altro problema durante l'installazione di Homebrew. L'interfaccia della riga di comando non usa un ambiente virtuale Python, quindi si basa sull'individuazione della versione di 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

È stata installata l'interfaccia della riga di comando versione 1.x

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 risultare impossibile ottenere risorse da Homebrew, a meno che non sia stato configurato correttamente 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

Update

L'interfaccia della riga di comando viene aggiornata regolarmente con correzioni di bug, miglioramenti, nuove funzioni e funzionalità in anteprima. Una nuova versione si rende disponibile all'incirca ogni tre settimane.

A partire dalla versione 2.11.0, l'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 le versioni dell'interfaccia della riga di comando di Azure precedenti alla versione 2.11.0, eseguire l'aggiornamento reinstallando come descritto in Installare l'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

Disinstalla

È possibile disinstallare l'interfaccia della riga di comando di Azure. 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 è stato rilevato un bug, segnalarlo in GitHub.

Usare Homebrew per disinstallare il pacchetto azure-cli.

brew uninstall azure-cli

Rimuovere i dati

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

rm -rf ~/.azure

Altri metodi di installazione

Se non è possibile usare Homebrew per installare l'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. È sempre consigliabile usare uno strumento di gestione pacchetti come Homebrew. Usare il metodo di installazione manuale solo se non sono disponibili altre opzioni.

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

Passaggi successivi

Dopo aver installato l'interfaccia della riga di comando di Azure in macOS, esaminare brevemente le funzionalità e i comandi comuni.