Installare interfaccia della riga di comando di Azure in macOS - Anteprima

interfaccia della riga di comando di Azure è uno strumento da riga di comando multipiattaforma per gestire le risorse Azure in modo interattivo o tramite script.

In macOS interfaccia della riga di comando di Azure sta passando dalla formula Homebrew Core a un modello di installazione più gestibile e flessibile. Il nuovo modello include:

  • Cask Homebrew (consigliato per la maggior parte degli utenti)
  • Tarball (consigliato per ambienti offline o isolati)

Questa esperienza è attualmente in anteprima e diventerà l'approccio di installazione standard in una versione futura.

Perché usare Homebrew Cask?

  • Esperienza di installazione e aggiornamento più semplice
  • Gestisce automaticamente le dipendenze
  • Allinea al modello di installazione supportato in futuro

Che cosa sta cambiando

interfaccia della riga di comando di Azure è in continua evoluzione per supportare l'autenticazione più sicura, inclusa l'autenticazione basata su broker. Queste funzionalità richiedono un modello di installazione basato su Cask. Di conseguenza, stiamo passando da Homebrew Core a Homebrew Cask. Questa modifica non rimuove o limita alcuna funzionalità di interfaccia della riga di comando di Azure esistente. Homebrew Cask è completamente compatibile con tutte le funzionalità e le versioni di interfaccia della riga di comando di Azure correnti.

Questa modifica migliora la coerenza tra gli ambienti e offre un supporto migliore per scenari come l'installazione offline e gli ambienti di distribuzione controllati.

Importante

interfaccia della riga di comando di Azure è attualmente in fase di anteprima per il modello di installazione Cask Homebrew. Durante questa fase, l'installazione è disponibile solo tramite un tocco Homebrew personalizzato.

  • Metodo corrente: brew install azure-cli
  • Nuovi metodi (fase di anteprima):
    • Homebrew Cask tramite tap personalizzato
      1. brew tap azure/azure-cli
      2. brew install --cask azure-cli-preview
    • Installazione basata su Tarball

Scegliere un metodo di installazione

Usare le indicazioni seguenti per selezionare il metodo di installazione più adatto allo scenario:

Scenario Metodo consigliato
Maggior parte degli utenti Homebrew Cask
Sistemi offline o isolati fisicamente Tarball
È richiesto un percorso di installazione personalizzato Tarball

Installare interfaccia della riga di comando di Azure con Homebrew Cask

Homebrew offre l'esperienza di installazione più semplice e gestibile per interfaccia della riga di comando di Azure in macOS. Gestisce l'installazione, gli aggiornamenti e la rimozione usando flussi di lavoro standard di gestione dei pacchetti.

Prerequisiti

  • macOS (Apple Silicon o Intel)
  • Homebrew installato

Se interfaccia della riga di comando di Azure è già installato usando la formula Homebrew, disinstallarlo prima di procedere per evitare conflitti:

brew uninstall azure-cli

Installare interfaccia della riga di comando di Azure

Si installa interfaccia della riga di comando di Azure utilizzando il cask di Homebrew dal tap personalizzato di interfaccia della riga di comando di Azure. Questo è l'unico metodo di installazione di Homebrew supportato durante la fase di anteprima.

brew tap azure/azure-cli
brew install --cask azure-cli-preview

Verifica l'installazione

Dopo l'installazione, verificare che interfaccia della riga di comando di Azure sia disponibile:

az --version

Aggiornare interfaccia della riga di comando di Azure

Per eseguire l'aggiornamento alla versione più recente:

brew update && brew upgrade --cask azure-cli-preview

Disinstallare interfaccia della riga di comando di Azure

Per rimuovere interfaccia della riga di comando di Azure:

brew uninstall --cask azure-cli-preview
brew untap azure/azure-cli

Dopo la fase di anteprima

Quando l'installazione di Homebrew Cask diventa disponibile a livello generale:

  • Il metodo di installazione dell'anteprima (azure-cli-preview tramite tocco personalizzato) verrà sospeso.
  • interfaccia della riga di comando di Azure sarà disponibile nel repository ufficiale Homebrew Cask.

Installare interfaccia della riga di comando di Azure usando:

brew install --cask azure-cli
# Or
brew install azure-cli

Le installazioni esistenti che usano la formula Homebrew Core devono eseguire la migrazione all'installazione basata su Cask. La formula Homebrew Core non sarà più supportata dopo questa transizione.

Installare interfaccia della riga di comando di Azure usando un tarball

Usare questo metodo se:

  • Homebrew non è disponibile
  • L'accesso a Internet è limitato
  • È necessario il controllo completo sul percorso di installazione

Questo metodo viene comunemente utilizzato in ambienti aziendali, regolamentati o isolati.

Prerequisiti

  • macOS (Apple Silicon o Intel)
  • Python 3.13 installato tramite qualsiasi metodo (python.org, pyenv e così via)

Scarica il tarball

Su un sistema con accesso a Internet, puoi scaricare automaticamente il tarball interfaccia della riga di comando di Azure più recente per la tua architettura.

ARCH=$(uname -m)
VER=$(curl -s https://api.github.com/repos/Azure/azure-cli/releases/latest | grep tag_name | cut -d '"' -f4 | sed 's/azure-cli-//')
curl -L -o az.tar.gz "https://github.com/Azure/azure-cli/releases/download/azure-cli-$VER/azure-cli-$VER-macos-$ARCH.tar.gz"

Questo script rileva l'architettura e scarica l'ultima tarball di interfaccia della riga di comando di Azure dalla pagina delle versioni di rilascio di interfaccia della riga di comando di Azure.

  • arm64 indica Apple Silicon
  • x86_64 indica Intel

La selezione dell'architettura corretta garantisce la compatibilità e le prestazioni ottimali.

Tip

Per gli ambienti offline, eseguire questo comando in un computer con accesso a Internet, quindi trasferire il file tarball scaricato nel sistema di destinazione.

Estrarre nella directory di installazione

Scegliere una directory in cui installare interfaccia della riga di comando di Azure:

mkdir -p $HOME/lib/azure-cli
tar -xzf az.tar.gz -C $HOME/lib/azure-cli

Configurare le variabili di ambiente

interfaccia della riga di comando di Azure richiede l'accesso a un runtime di Python. Configurare l'ambiente in modo che punti a Python e ai file binari della CLI di Azure.

Aggiungere quanto segue al profilo della shell (~/.zshrc o ~/.bashrc):

export AZ_PYTHON="/path_to_python"
export PATH="/target_directory_path/bin:$PATH"

Ricarica la configurazione della shell:

source ~/.zshrc

Verifica l'installazione

az --version

Aggiornare interfaccia della riga di comando di Azure

Per aggiornare interfaccia della riga di comando di Azure in un ambiente offline, scaricare un file Tarball più recente ed estrarlo tramite l'installazione esistente:

sudo tar -xzf az.tar.gz -C /target_directory_path

Disinstallare interfaccia della riga di comando di Azure

Eliminare la directory di installazione:

sudo rm -rf /target_directory_path

Rimuovi le voci AZ_PYTHON e PATH dal tuo profilo della shell.

Troubleshooting

Se si verifica un problema durante l'installazione o l'uso del interfaccia della riga di comando di Azure con Homebrew Cask o il metodo Tarball, ecco alcuni errori comuni (molti dei quali sono specifici di Homebrew). Se si verifica un problema non trattato in questo articolo, segnalarlo in GitHub.

interfaccia della riga di comando di Azure non trovato

Assicurati che la tua PATH includa la directory di installazione:

echo $PATH

Il completamento non funziona

L'installazione di interfaccia della riga di comando di Azure Homebrew (tramite formula o cask) fornisce un file di completamento denominato az nella directory dei completamenti gestiti di Homebrew. Per abilitare il completamento, seguire le istruzioni di Homebrew.

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 verificarsi un disallineamento della versione minore o un altro problema durante l'installazione di homebrew. 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.13 da Homebrew.

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

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.

Importante

Se si è dietro un proxy, è necessario impostare HTTP_PROXY e HTTPS_PROXY per connettersi ai servizi di Azure con il interfaccia della riga di comando di Azure. Se non si usa l'autenticazione di base, è consigliabile esportare queste variabili nel .bashrc file. Seguire sempre i criteri di sicurezza aziendale e i requisiti definiti dall'amministratore di sistema.

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

Operazioni successive

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

Introduzione all'interfaccia della riga di comando di Azure

  • Last updated on