Installare il Azure CLI in Linux

Prima di iniziare

• Azure CLI 2.38.2 (rilasciata il 21 giugno 2024) è l'ultima versione supportata in RHEL 7 e Centos 7. Microsoft non fornisce più aggiornamenti o correzioni di bug per queste distribuzioni.

• Usa il gestore yum dei pacchetti se stai usando un sistema Linux che non supporta il gestore dnf dei pacchetti.

Installare Azure CLI

Per installare il Azure CLI, seguire questa procedura:

1. Importa la chiave del repository Microsoft. Per RHEL 10 e CentOS Stream 10,

   sudo rpm --import https://packages.microsoft.com/keys/microsoft-2025.asc
   

   Per le versioni precedenti, usare il comando seguente:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
   

2. Per RHEL 10, aggiungere packages-microsoft-com-prod il repository:

   sudo dnf install -y https://packages.microsoft.com/config/rhel/10/packages-microsoft-prod.rpm
   

   Per CentOS Stream 10, aggiungere il repository packages-microsoft-com-prod.

   sudo dnf install -y https://packages.microsoft.com/config/centos/10/packages-microsoft-prod.rpm
   

   Per RHEL 9 o CentOS Stream 9, aggiungere packages-microsoft-com-prod il repository:

   sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm
   

   Per RHEL 8, aggiungere packages-microsoft-com-prod il repository:

   sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
   

   Per RHEL 7, aggiungere azure-cli il repository:

   echo -e "[azure-cli]
   name=Azure CLI
   baseurl=https://packages.microsoft.com/yumrepos/azure-cli
   enabled=1
   gpgcheck=1
   gpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/azure-cli.repo
   

   Attenzione

   CentOS 7 End Of Life (EOL) è stato il 30 giugno 2024. Per informazioni sugli ambienti supportati Azure CLI, vedere Azure CLI ciclo di vita del supporto

3. Eseguire l'installazione con il comando dnf install.

   sudo dnf install azure-cli
   

Installare una versione specifica

È prima necessario configurare azure-cli le informazioni sul repository come illustrato in precedenza. Le versioni disponibili possono essere trovate in Azure CLI note di rilascio.

1. Per visualizzare le versioni disponibili con il comando :

   dnf list --showduplicates azure-cli
   

2. Per installare una versione specifica:

   sudo dnf install azure-cli-<version>-1.el7
   

Aggiornare Azure CLI

A partire dalla versione 2.11.0, il Azure CLI 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 Azure CLI versioni precedenti a 2.11.0, eseguire l'aggiornamento reinstallando come descritto in Installare il Azure CLI.

È anche possibile aggiornare il Azure CLI con il comando dnf update.

sudo dnf update azure-cli

Disinstallare Azure CLI

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

1. Rimuovere il pacchetto dal sistema.

   sudo dnf remove azure-cli
   

2. Se non si prevede di reinstallare l'interfaccia a riga di comando, rimuovere le informazioni del repository.

   sudo rm /etc/yum.repos.d/azure-cli.repo
   

3. Se non si usano altri pacchetti Microsoft, rimuovere la chiave di firma.

   MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
   sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
   

Rimuovere i dati

Se non si prevede di reinstallare Azure CLI, rimuovere i dati.

rm -rf ~/.azure

Risoluzione dei problemi

Di seguito sono riportati alcuni problemi comuni che possono verificarsi durante l'installazione con dnf. Se si verifica un problema non trattato qui, file un problema in GitHub.

Eseguire l'installazione in RHEL 7.6 o in altri sistemi senza Python 3

Se possibile, aggiorna il sistema a una versione con il supporto ufficiale per il pacchetto python 3.6+. In caso contrario, è necessario installare prima un pacchetto python3, quindi installare Azure CLI senza dipendenza.

È possibile usare il comando seguente per scaricare e installare lo script di installazione Azure CLI con python 3.6 compilato dall'origine:

curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

È anche possibile eseguire questo codice passo passo:

Prima di tutto, Azure CLI richiede SSL 1.1+ ed è necessario compilare openssl 1.1 dall'origine prima di compilare python3:

sudo dnf install gcc gcc-c++ make ncurses patch wget tar zlib zlib-devel -y
# build openssl from source
cd ~
wget https://www.openssl.org/source/openssl-1.1.1d.tar.gz
tar -xzf openssl-1.1.1d.tar.gz
cd openssl-1.1.1d
./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl
make
sudo make install
# configure shared object lookup directory so that libssl.so.1.1 can be found
echo "/usr/local/ssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1d.conf
# reload config
sudo ldconfig -v

Compilare quindi Python 3 dall'origine:

PYTHON_VERSION="3.6.9"
PYTHON_SRC_DIR=$(mktemp -d)
wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
cd $PYTHON_SRC_DIR/Python-$PYTHON_VERSION
./configure --prefix=/usr --with-openssl=/usr/local/ssl
make
sudo make install

Seguire infine i passaggi 1 e 2 dell'istruzione installare per aggiungere il repository Azure CLI. A questo punto è possibile scaricare il pacchetto e installarlo senza dipendenza.

sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm

In alternativa, è anche possibile installare Python 3 usando altro repository. Usare questo metodo, se è stato configurato python3 ma viene comunque visualizzato l'errore python3: command not found. Assicurati che sia stato incluso nel percorso.

scl enable rh-python36 bash

Il proxy blocca la connessione

Se non è possibile connettersi a una risorsa esterna a causa di un proxy, assicurarsi di aver impostato correttamente le variabili HTTP_PROXY e HTTPS_PROXY nella shell. È necessario contattare l'amministratore di sistema per conoscere gli host e le porte da usare per questi proxy.

I valori in queste variabili vengono usati da molti programmi Linux e durante il processo di installazione. Per impostare questi valori:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

È anche possibile configurare dnf in modo esplicito per usare sempre questo proxy. Assicurarsi che nella sezione [main] di /etc/dnf/dnf.conf siano presenti le righe seguenti:

[main]
# ...
proxy=http://[proxy]:[port] # If your proxy requires https, change http->https
proxy_username=[username] # Only required for basic auth
proxy_password=[password] # Only required for basic auth

Per ottenere la chiave di firma Microsoft e il pacchetto dal repository, il proxy deve consentire le connessioni HTTPS all'indirizzo seguente:

• https://packages.microsoft.com

L'interfaccia della riga di comando non viene installata o eseguita in Windows Subsystem for Linux

Poiché Windows Subsystem for Linux (WSL) è un livello di conversione delle chiamate di sistema sopra la piattaforma Windows, è possibile che si verifichi un errore quando si tenta di installare o eseguire il Azure CLI. L'interfaccia della riga di comando usa alcune funzionalità che potrebbero contenere un bug in WSL. Se si verifica un errore indipendentemente dal modo in cui si installa l'interfaccia della riga di comando, è probabile che il problema riguardi WSL e non il processo di installazione dell'interfaccia della riga di comando.

Per risolvere i problemi dell'installazione di WSL e possibilmente trovare soluzioni:

• Se possibile, eseguire un processo di installazione identico in un computer o una VM Linux per verificare se ha esito positivo. In caso affermativo, è probabile che il problema sia correlato a WSL. Per avviare una macchina virtuale Linux in Azure, vedere la documentazione creare una macchina virtuale Linux nel portale di Azure.
• Verificare di eseguire l'ultima versione di WSL. Per ottenere la versione più recente, aggiornare l'installazione Windows 10.
• Verificare la presenza di eventuali problemi aperti con WSL che potrebbero risolvere il problema. Spesso sono disponibili suggerimenti su come risolvere il problema o informazioni su una versione in cui è stato risolto il problema.
• Se non si trovano problemi esistenti per il problema riscontrato, segnalare un nuovo problema relativo a WSL assicurandosi di includere la maggiore quantità di informazioni possibile.

Se continuate a riscontrare problemi durante l'installazione o l'esecuzione in WSL, prendere in considerazione l'installazione del CLI per Windows.

Prima di iniziare

• Azure CLI 2.38.2 (rilasciata il 21 giugno 2024) è la versione più recente supportata in SUSE Linux Enterprise Server (SLES) e OpenSUSE (Leap). Microsoft non fornisce più aggiornamenti o correzioni di bug per queste distribuzioni.

• SUSE gestisce e supporta i pacchetti forniti dai repository SUSE/OpenSUSE.

• In Azure le macchine virtuali SUSE e OpenSUSE basate su immagini Azure Marketplace hanno già installato il Azure CLI.

Installare Azure CLI

Per installare Azure CLI in SUSE/OpenSUSE, scegliere uno dei metodi seguenti:

1. Usare il pacchetto Enterprise fornito da SUSE nei repository SUSE/OpenSUSE.

2. Usare il metodo di installazione descritto nella scheda "Installa script (qualsiasi)".

3. Installare dai repository di Microsoft

Eseguire l'installazione da repository SUSE o OpenSUSE

Il pacchetto RPM del Azure CLI dipende dal pacchetto python3.

sudo zypper install -y azure-cli

Installare dai repository di Microsoft

Per installare la versione cronologica più recente del Azure CLI usando i repository Microsoft, seguire questa procedura.

Questo pacchetto è stato testato con SLES 15 e OpenSUSE Leap 15.1)

1. Installare curl:

   sudo zypper install -y curl
   

2. Importare la chiave del repository Microsoft:

   sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
   

3. Creare le informazioni del repository locale azure-cli

   sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
   

4. Aggiornare l'indice del pacchetto zypper ed eseguire l'installazione:

   sudo zypper install --from azure-cli azure-cli
   

   Digitare 2 per procedere con l'installazione ignorando alcune dipendenze.

Installare una versione specifica

È prima necessario configurare azure-cli le informazioni sul repository come illustrato in precedenza. Le versioni disponibili sono disponibili nelle note sulla versione Azure CLI.

1. Visualizzare le versioni disponibili usando questo comando:

   zypper search --details --match-exact azure-cli
   

2. Per installare una versione specifica:

   sudo zypper install --from azure-cli azure-cli=<version>-1.el7
   

Aggiornare Azure CLI

A partire dalla versione 2.11.0, il Azure CLI 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 Azure CLI versioni precedenti a 2.11.0, eseguire l'aggiornamento reinstallando come descritto in Installare il Azure CLI.

È anche possibile aggiornare il pacchetto con il comando zypper update.

sudo zypper refresh
sudo zypper update azure-cli

Disinstallare Azure CLI

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

1. Rimuovere il pacchetto dal sistema.

   sudo zypper remove -y azure-cli
   

2. Se non si prevede di reinstallare l'interfaccia a riga di comando, rimuovere le informazioni del repository.

   sudo zypper removerepo azure-cli
   

3. Se non si usano altri pacchetti Microsoft, rimuovere la chiave di firma Microsoft.

   MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
   sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
   

Rimuovere i dati

Se non si prevede di reinstallare Azure CLI, rimuovere i dati.

rm -rf ~/.azure

Risoluzione dei problemi

Di seguito sono riportati alcuni problemi comuni che possono verificarsi durante l'installazione con zypper. Se si verifica un problema non trattato qui, file un problema in GitHub.

Installare senza Python 3

NotImplementedError sulla VM OpenSUSE 15

La macchina virtuale OpenSUSE 15 ha un Azure CLI preinstallato con la versione 2.0.45, obsoleta e presenta problemi con az login. Rimuovere questa versione insieme alle relative dipendenze prima di seguire l'istruzione Install per aggiungere l'Azure CLI più recente:

sudo zypper rm -y --clean-deps azure-cli

Se il Azure CLI è stato aggiornato senza rimuovere le dipendenze della versione 2.0.45, le dipendenze precedenti potrebbero influire sulla versione più recente del Azure CLI. È necessario aggiungere di nuovo la versione precedente per collegarla alle relative dipendenze, quindi rimuovere azure-cli insieme alle dipendenze:

# The package name may vary on different system version, run 'zypper --no-refresh info azure-cli' to check the source package format
sudo zypper install --oldpackage azure-cli-2.0.45-4.22.noarch

sudo zypper rm -y --clean-deps azure-cli

Eseguire l'installazione in SLES 12 o in altri sistemi senza Python 3.6

In SLES 12 il pacchetto predefinito python3 è 3.4 e non è supportato da Azure CLI. Eseguire prima i passaggi da 1 a 3 delle istruzioni di installazione per aggiungere il repository azure-cli. Quindi costruisci una versione superiore di python3 dal sorgente. Infine, è possibile scaricare il pacchetto Azure CLI e installarlo senza dipendenza.

È possibile usare il comando seguente per installare o aggiornare Azure CLI in base ai passaggi precedenti. Lo script installa Python 3.8 in /usr/local/azcli e Azure CLI lo usa impostando un alias di az su PATH=/usr/local/azcli/bin:$PATH az. È anche possibile scaricare lo script e modificarlo in base alle proprie esigenze. Ad esempio, è possibile modificare la versione Python o il percorso di installazione.

curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash

Per la prima installazione, ricordarsi di eseguire il comando seguente per attivare l'alias:

source ~/.bashrc

Il proxy blocca la connessione

Se non è possibile connettersi a una risorsa esterna a causa di un proxy, assicurarsi di aver impostato correttamente le variabili HTTP_PROXY e HTTPS_PROXY nella shell. È necessario contattare l'amministratore di sistema per conoscere gli host e le porte da usare per questi proxy.

I valori in queste variabili vengono usati da molti programmi Linux e durante il processo di installazione. Per impostare questi valori:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

È anche possibile configurare zypper in modo esplicito (tramite yast2) per usare sempre questo proxy. A questo scopo, eseguire il comando yast2 proxy come utente con privilegi avanzati e inserire le informazioni richieste nel modulo. Se nel sistema è disponibile un gestore finestre, è anche possibile usare il riquadro Network Services > Proxy in YaST Control Center.

Per la configurazione avanzata o per altre informazioni, vedere la documentazione relativa alla configurazione dei proxy in OpenSUSE.

Per ottenere la chiave di firma Microsoft e ottenere il pacchetto dal repository, il proxy deve consentire le connessioni HTTPS agli indirizzi seguenti:

• https://packages.microsoft.com
• https://download.opensuse.org

L'interfaccia della riga di comando non viene installata o eseguita in Windows Subsystem for Linux

Poiché Windows Subsystem for Linux (WSL) è un livello di conversione delle chiamate di sistema sopra la piattaforma Windows, è possibile che si verifichi un errore quando si tenta di installare o eseguire il Azure CLI. L'interfaccia della riga di comando usa alcune funzionalità che potrebbero contenere un bug in WSL. Se si verifica un errore indipendentemente dal modo in cui si installa l'interfaccia della riga di comando, è probabile che il problema riguardi WSL e non il processo di installazione dell'interfaccia della riga di comando.

Per risolvere i problemi dell'installazione di WSL e possibilmente trovare soluzioni:

• Se possibile, eseguire un processo di installazione identico in un computer o una VM Linux per verificare se ha esito positivo. In caso affermativo, è probabile che il problema sia correlato a WSL. Per avviare una macchina virtuale Linux in Azure, vedere la documentazione creare una macchina virtuale Linux nel portale di Azure.
• Verificare di eseguire l'ultima versione di WSL. Per ottenere la versione più recente, aggiornare l'installazione Windows 10.
• Verificare la presenza di eventuali problemi aperti con WSL che potrebbero risolvere il problema. Spesso sono disponibili suggerimenti su come risolvere il problema o informazioni su una versione in cui è stato risolto il problema.
• Se non si trovano problemi esistenti per il problema riscontrato, segnalare un nuovo problema relativo a WSL assicurandosi di includere la maggiore quantità di informazioni possibile.

Se continuate a riscontrare problemi durante l'installazione o l'esecuzione in WSL, prendere in considerazione l'installazione del CLI per Windows.

Problema del certificato SSL

Quando un certificato è danneggiato o obsoleto in un computer, è possibile che venga visualizzato un errore che indica che curl non è riuscito a verificare la legittimità del server e pertanto non è stato possibile stabilire una connessione sicura. Aggiornare il certificato per correggere il problema.

sudo zypper update-ca-certificates

Prima di iniziare

• La gestione pacchetti apt contiene pacchetti x86_64 e ARM64 per i Azure CLI testati nelle distribuzioni seguenti.

  Distribuzione	Versione
  Debian	11 (Bullseye), 12 (Topo di biblioteca)
  Ubuntu	22.04 (Jammy Medfish), 24.04 (Nobile Numbat)

Installare Azure CLI

Sono disponibili due opzioni per installare il Azure CLI nel sistema. È possibile scaricare uno script di installazione che esegue automaticamente i comandi di installazione oppure eseguire manualmente i comandi di installazione in un processo dettagliato. Entrambi i metodi sono disponibili qui:

Opzione 1: Installare con un comando

Il modo più semplice per installare il Azure CLI consiste nell'usare uno script gestito dal team Azure CLI. Questo script esegue tutti i comandi di installazione in un unico passaggio. Questo script viene scaricato tramite curl e inviato tramite pipe direttamente a bash per installare l'interfaccia della riga di comando.

Se si vuole esaminare manualmente il contenuto dello script prima dell'esecuzione, scaricare lo script prima di usare curl ed esaminarlo nell'editor di testo preferito.

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Opzione 2: istruzioni dettagliate per l'installazione

Se si preferisce un processo di installazione dettagliato, completare la procedura seguente per installare il Azure CLI.

1. Ottenere i pacchetti necessari per il processo di installazione:

   sudo apt-get update
   sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
   

2. Scaricare e installare la chiave di firma Microsoft:

   sudo mkdir -p /etc/apt/keyrings
   curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
     gpg --dearmor | sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null
   sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
   

3. Aggiungi il repository software Azure CLI:

   AZ_DIST=$(lsb_release -cs)
   echo "Types: deb
   URIs: https://packages.microsoft.com/repos/azure-cli/
   Suites: ${AZ_DIST}
   Components: main
   Architectures: $(dpkg --print-architecture)
   Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources
   

4. Aggiornare le informazioni del repository e installare il pacchetto azure-cli:

   sudo apt-get update
   sudo apt-get install azure-cli
   

Installare una versione specifica

Configurare le informazioni sul azure-cli repository come illustrato in precedenza. Le versioni disponibili possono essere trovate in Azure CLI note di rilascio.

1. Visualizzare le versioni disponibili del Azure CLI.

   apt-cache policy azure-cli
   

2. Installare una versione specifica.

   # Obtain the currently installed distribution
   AZ_DIST=$(lsb_release -cs)
   
   # Store an Azure CLI version of choice
   AZ_VER=2.51.0
   
   # Install a specific version
   sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}
   

   Per installare una versione specifica senza variabili, sostituire la versione di Azure CLI e il nome della distribuzione Linux visualizzati:

   sudo apt-get install azure-cli=2.51.0-1~bullseye
   

Se viene visualizzato il messaggio di errore Non è possibile individuare il pacchetto azure-cli, le informazioni sul azure-cli repository non sono configurate. Seguire i passaggi indicati in Opzione 2: istruzioni dettagliate per l'installazione.

Se visualizzi il messaggio di errore Versione x.xx.x-1~distributionName per azure-cli non trovato, utilizza lsb_release -cs per trovare la distribuzione in esecuzione.

Aggiornare Azure CLI

A partire dalla versione 2.11.0, il Azure CLI 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 Azure CLI versioni precedenti a 2.11.0, eseguire l'aggiornamento reinstallando come descritto in Installare il Azure CLI.

È anche possibile usare apt-get upgrade per aggiornare il pacchetto dell'interfaccia della riga di comando. Questo comando aggiorna tutti i pacchetti installati nel sistema che non hanno avuto una modifica delle dipendenze.

sudo apt-get update && sudo apt-get upgrade

Per eseguire l'aggiornamento solo dell'interfaccia della riga di comando, usare apt-get install.

sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli

Disinstallare Azure CLI

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

1. Eseguire la disinstallazione con apt-get remove:

   sudo apt-get remove -y azure-cli
   

2. Se non si prevede di reinstallare l'interfaccia della riga di comando, rimuovere le informazioni sul repository Azure CLI:

   sudo rm /etc/apt/sources.list.d/azure-cli.sources
   

3. Se non si usano altri pacchetti di Microsoft, rimuovere la chiave di firma:

   sudo rm /etc/apt/keyrings/microsoft.gpg
   

4. Rimuovere eventuali pacchetti non necessari:

   sudo apt autoremove
   

Rimuovere i dati

Se non si prevede di reinstallare Azure CLI, rimuovere i dati.

rm -rf ~/.azure

Risoluzione dei problemi

Di seguito sono riportati alcuni problemi comuni che possono verificarsi durante l'installazione con apt. Se si verifica un problema non trattato qui, file un problema in GitHub.

Il azure-cli pacchetto supporta l'architettura ARM64 dalla versione della CLI 2.46.0.

lsb_release non restituisce la versione di distribuzione di base corretta

Alcune distribuzioni derivate da Ubuntu o debian (ad esempio Linux Mint) potrebbero non restituire il nome di versione corretto da lsb_release. Questo valore viene usato nel processo di installazione per determinare il pacchetto da installare. Se si conosce il nome di codice della versione Ubuntu o Debian da cui deriva la distribuzione, è possibile impostare il AZ_REPO valore manualmente quando si aggiunge il repository. In caso contrario, cercare le informazioni relative alla distribuzione in uso in merito a come determinare il nome in codice della distribuzione base e impostare AZ_REPO sul valore corretto.

Nessun pacchetto per la tua distribuzione

In alcuni casi, un pacchetto di Azure CLI aggiornato non è immediatamente disponibile dopo una versione di distribuzione. Il Azure CLI è progettato per essere resiliente alle versioni future delle dipendenze e si basa sul minor numero possibile di dipendenze. Se non è disponibile alcun pacchetto per la distribuzione base in uso, provare un pacchetto per una distribuzione precedente.

Per provare un pacchetto per una distribuzione precedente, impostare il valore di AZ_REPO manualmente quando si aggiunge il repository. Per le distribuzioni Ubuntu, usare il repository più recente jammy :

AZ_REPO="jammy"

Per le distribuzioni Debian, usare il repository più recente bookworm :

AZ_REPO="bookworm"

Il sistema operativo elementare (EOS) non riesce a installare il Azure CLI

EOS non riesce a installare il Azure CLI perché lsb_release restituisce HERA, ovvero il nome della versione EOS. La soluzione consiste nel correggere il file /etc/apt/sources.list.d/azure-cli.sources e modificare Suites: hera in Suites: bionic.

Contenuto del file originale:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Contenuto del file modificato

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Il proxy blocca la connessione

Se non è possibile connettersi a una risorsa esterna a causa di un proxy, assicurarsi di aver impostato correttamente le variabili HTTP_PROXY e HTTPS_PROXY nella shell. È necessario contattare l'amministratore di sistema per conoscere gli host e le porte da usare per questi proxy.

I valori in queste variabili vengono usati da molti programmi Linux e durante il processo di installazione. Per impostare questi valori:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

È anche possibile configurare apt in modo esplicito per usare sempre questo proxy. Assicurarsi che nella sezione apt di un file di configurazione di /etc/apt/apt.conf.d/ siano presenti le righe seguenti. È consigliabile usare il file di configurazione globale esistente, un file di configurazione proxy esistente, 40proxies o 99local. In ogni caso, attenersi ai requisiti previsti dall'amministrazione del sistema.

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

Se il proxy non usa l'autenticazione di base, rimuovere la [username]:[password]@ parte dell'URI proxy. Per maggiori informazioni sulla configurazione del proxy, vedere la documentazione ufficiale di Ubuntu:

• apt.conf man page
• Wiki di Ubuntu - Procedura per apt-get

Per ottenere la chiave di firma Microsoft e ottenere il pacchetto dal repository, il proxy deve consentire le connessioni HTTPS all'indirizzo seguente: 'https://packages.microsoft.com.

L'interfaccia della riga di comando non viene installata o eseguita in Windows Subsystem for Linux

Poiché Windows Subsystem for Linux (WSL) è un livello di conversione delle chiamate di sistema sopra la piattaforma Windows, è possibile che si verifichi un errore quando si tenta di installare o eseguire il Azure CLI. L'interfaccia della riga di comando usa alcune funzionalità che potrebbero contenere un bug in WSL. Se si verifica un errore indipendentemente dal modo in cui si installa l'interfaccia della riga di comando, è probabile che il problema riguardi WSL e non il processo di installazione dell'interfaccia della riga di comando.

Per risolvere i problemi dell'installazione di WSL e possibilmente trovare soluzioni:

• Se possibile, eseguire un processo di installazione identico in un computer o una VM Linux per verificare se ha esito positivo. In caso affermativo, è probabile che il problema sia correlato a WSL. Per avviare una macchina virtuale Linux in Azure, vedere la documentazione creare una macchina virtuale Linux nel portale di Azure.
• Verificare di eseguire l'ultima versione di WSL. Per ottenere la versione più recente, aggiornare l'installazione Windows 10.
• Verificare la presenza di eventuali problemi aperti con WSL che potrebbero risolvere il problema. Spesso sono disponibili suggerimenti su come risolvere il problema o informazioni su una versione in cui è stato risolto il problema.
• Se non si trovano problemi esistenti per il problema riscontrato, segnalare un nuovo problema relativo a WSL assicurandosi di includere la maggiore quantità di informazioni possibile.

Se continuate a riscontrare problemi durante l'installazione o l'esecuzione in WSL, prendere in considerazione l'installazione del CLI per Windows.

Installare Azure CLI

Le rpm vengono rilasciate per Azure Linux tramite CBL-Mariner. Il azure-cli pacchetto supporta l'architettura ARM64 dalla versione della CLI 2.46.0.

Per installare il Azure CLI, seguire questa procedura:

1. Installare il set ufficiale di certificati radice attendibili selezionati da Microsoft.

   sudo tdnf install ca-certificates
   

2. Installare Azure CLI:

   sudo tdnf install azure-cli
   

Installare una versione specifica

Le versioni disponibili possono essere trovate in Azure CLI note di rilascio.

Per visualizzare le versioni disponibili con il comando :

tdnf list azure-cli

Per installare una versione specifica:

sudo tdnf install azure-cli-<version>-1

Aggiornare Azure CLI

Aggiornare il Azure CLI con il comando tdnf update:

sudo tdnf update azure-cli

Disinstallare Azure CLI

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

Rimuovere il pacchetto dal sistema:

sudo tdnf remove azure-cli

Rimuovere i dati

Se non si prevede di reinstallare Azure CLI, rimuovere i dati.

rm -rf ~/.azure