Installare l'interfaccia della riga di comando di Azure con APTInstall Azure CLI with apt

Se si esegue una distribuzione che include apt, ad esempio Ubuntu o Debian, è disponibile un pacchetto x86_64 per l'interfaccia della riga di comando di Azure.If you are running a distribution that comes with apt, such as Ubuntu or Debian, there's an x86_64 package available for the Azure CLI. Questo pacchetto è supportato per i sistemi operativi seguenti con cui è stato testato:This package has been tested with and is supported for:

  • Ubuntu trusty, xenial, artful, bionic e discoUbuntu trusty, xenial, artful, bionic, and disco
  • Debian wheezy, jessie, stretch e busterDebian wheezy, jessie, stretch, and buster

La versione corrente dell'interfaccia della riga di comando di Azure è 2.0.80.The current version of the Azure CLI is 2.0.80. Per informazioni sulla versione più recente, vedere le note sulla versione.For information about the latest release, see the release notes. Per individuare la versione installata e verificare se è necessario aggiornarla, eseguire az --version.To find your installed version and see if you need to update, run az --version.

Nota

Il pacchetto per l'interfaccia della riga di comando di Azure installa uno specifico interprete Python e non usa l'istanza di Python del sistema.The package for Azure CLI installs its own Python interpreter, and does not use the system Python.

InstallaInstall

Sono disponibili due modi per installare l'interfaccia della riga di comando di Azure con le distribuzioni che supportano apt: con uno script all-in-one che esegue automaticamente i comandi di installazione e con istruzioni che è possibile eseguire manualmente come una procedura dettagliata.We offer two ways to install the Azure CLI with distributions that support apt: As an all-in-one script that runs the install commands for you, and instructions that you can run as a step-by-step process on your own.

Eseguire l'installazione con un unico comandoInstall with one command

È disponibile uno script che esegue tutti i comandi di installazione in un unico passaggio.We offer and maintain a script which runs all of the installation commands in one step. Eseguirlo con curl e inviarlo tramite pipe direttamente a bash o scaricare lo script in un file ed esaminarlo prima dell'esecuzione.Run it by using curl and pipe directly to bash, or download the script to a file and inspect it before running.

Importante

Questo script è stato verificato solo per Ubuntu 16.04+ e Debian 8+.This script is only verified for Ubuntu 16.04+ and Debian 8+. Potrebbe non funzionare in altre distribuzioni.It may not work on other distributions. Se si usa una distribuzione derivata, ad esempio Linux Mint, seguire le istruzioni di installazione manuale ed eseguire le procedure di risoluzione dei problemi necessarie.If you're using a derived distribution such as Linux Mint, follow the manual install instructions and perform any necessary troubleshooting.

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

Istruzioni di installazione manualeManual install instructions

Se non si vuole eseguire uno script come utente con privilegi avanzati, oppure se lo script all-in-one non riesce, seguire questa procedura per installare l'interfaccia della riga di comando di Azure.If you don't want to run a script as superuser or the all-in-one script fails, follow these steps to install the Azure CLI.

  1. Ottenere i pacchetti necessari per il processo di installazione:Get packages needed for the install process:

    sudo apt-get update
    sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. Scaricare e installare la chiave di firma Microsoft:Download and install the Microsoft signing key:

    curl -sL https://packages.microsoft.com/keys/microsoft.asc | 
        gpg --dearmor | 
        sudo tee /etc/apt/trusted.gpg.d/microsoft.asc.gpg > /dev/null
    
  3. Aggiungere il repository software dell'interfaccia della riga di comando di Azure:Add the Azure CLI software repository:
    AZ_REPO=$(lsb_release -cs)
    echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" | 
        sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. Aggiornare le informazioni del repository e installare il pacchetto azure-cli:Update repository information and install the azure-cli package:

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

Eseguire l'interfaccia della riga di comando di Azure con il comando az.Run the Azure CLI with the az command. Per accedere, usare il comando az login.To sign in, use the az login command.

  1. Eseguire il comando login.Run the login command.

    az login
    

    Se l'interfaccia della riga di comando può aprire il browser predefinito, eseguirà questa operazione e caricherà una pagina di accesso di Azure.If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    In caso contrario, aprire una pagina del browser all'indirizzo https://aka.ms/devicelogin e immettere il codice di autorizzazione visualizzato nel terminale.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. Accedere con le credenziali dell'account nel browser.Sign in with your account credentials in the browser.

Per altre informazioni sui diversi metodi di autenticazione, vedere Accedere con l'interfaccia della riga di comando di Azure.To learn more about different authentication methods, see Sign in with Azure CLI.

risoluzione dei problemiTroubleshooting

Di seguito sono riportati alcuni problemi comuni che possono verificarsi durante l'installazione con apt.Here are some common problems seen when installing with apt. Se si verifica un problema non trattato in questo articolo, segnalarlo in GitHub.If you experience a problem not covered here, file an issue on github.

lsb_release non restituisce la versione della distribuzione base correttalsb_release does not return the correct base distribution version

Alcune distribuzioni derivate da Ubuntu o Debian, come Linux Mint, potrebbero non restituire il nome di versione corretto tramite lsb_release.Some Ubuntu- or Debian-derived distributions such as Linux Mint may not return the correct version name from lsb_release. Questo valore viene usato nel processo di installazione per determinare il pacchetto da installare.This value is used in the install process to determine the package to install. Se si conosce il nome in codice della versione di Ubuntu o Debian da cui deriva la distribuzione in uso, è possibile impostare manualmente il valore di AZ_REPO durante l'aggiunta del repository.If you know the code name of the Ubuntu or Debian version your distribution is derived from, you can set the AZ_REPO value manually when adding the 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.Otherwise, look up information for your distribution on how to determine the base distribution code name and set AZ_REPO to the correct value.

Nessun pacchetto per la distribuzione in usoNo package for your distribution

Talvolta dopo il rilascio di una distribuzione può trascorrere tempo prima che sia disponibile un pacchetto dell'interfaccia della riga di comando di Azure per tale distribuzione.Sometimes it may be a while after a distribution is released before there's an Azure CLI package available for it. L'interfaccia della riga di comando di Azure è progettata per essere resiliente rispetto alle versioni future delle dipendenze e usarne il minor numero possibile.The Azure CLI designed to be resilient with regards to future versions of dependencies and rely on as few of them as possible. Se non è disponibile alcun pacchetto per la distribuzione base in uso, provare un pacchetto per una distribuzione precedente.If there's no package available for your base distribution, try a package for an earlier distribution.

A tale scopo, impostare manualmente il valore di AZ_REPO durante l'aggiunta del repository.To do this, set the value of AZ_REPO manually when adding the repository. Usare il repository bionic per le distribuzioni Ubuntu e stretch per le distribuzioni Debian.For Ubuntu distributions use the bionic repository, and for Debian distributions use stretch. Le distribuzioni rilasciate prima di Ubuntu Trusty e Debian Wheezy non sono supportate.Distributions released before Ubuntu Trusty and Debian Wheezy are not supported.

Il proxy blocca la connessioneProxy blocks connection

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.If you're unable to connect to an external resource due to a proxy, make sure that you've correctly set the HTTP_PROXY and HTTPS_PROXY variables in your shell. Per sapere quali host e porte usare per questi proxy, è necessario contattare l'amministratore di sistema.You will need to contact your system administrator to know what host(s) and port(s) to use for these proxies.

Questi valori vengono rispettati da numerosi programmi Linux, inclusi quelli usati nel processo di installazione.These values are respected by many Linux programs, including those which are used in the install process. Per impostare questi valori:To set these values:

# 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]

Importante

Se si è protetti da un proxy, è necessario impostare queste variabili della shell per connettersi ai servizi di Azure con l'interfaccia della riga di comando.If you are behind a proxy, these shell variables must be set to connect to Azure services with the CLI. Se non si usa l'autenticazione di base, è consigliabile esportare queste variabili nel file .bashrc.If you are not using basic auth, it's recommended to export these variables in your .bashrc file. Seguire sempre i criteri di sicurezza aziendale e i requisiti definiti dall'amministratore di sistema.Always follow your business' security policies and the requirements of your system administrator.

Per usare sempre questo proxy, è opportuno configurare in modo esplicito apt.You may also want to explicitly configure apt to use this proxy at all times. Assicurarsi che nella sezione /etc/apt/apt.conf.d/ di un file di configurazione di apt siano presenti le righe seguenti.Make sure that the following lines appear in an apt configuration file in /etc/apt/apt.conf.d/. È 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.We recommend using either your existing global configuration file, an existing proxy configuration file, 40proxies, or 99local, but follow your system administration requirements.

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 parte [username]:[password]@ dell'URI del proxy.If your proxy does not use basic auth, remove the [username]:[password]@ portion of the proxy URI. Per maggiori informazioni sulla configurazione del proxy, vedere la documentazione ufficiale di Ubuntu:If you require more information for proxy configuration, see the official Ubuntu documentation:

Per ottenere la chiave di firma Microsoft e il pacchetto dal repository, il proxy deve consentire le connessioni HTTPS all'indirizzo seguente:In order to get the Microsoft signing key and get the package from our repository, your proxy needs to allow HTTPS connections to the following address:

  • https://packages.microsoft.com

Non è possibile installare o eseguire l'interfaccia della riga di comando nel sottosistema Windows per LinuxCLI fails to install or run on Windows Subsystem for Linux

Dato che il sottosistema Windows per Linux (WSL) è un livello di conversione delle chiamate di sistema basato sulla piattaforma Windows, potrebbe verificarsi un errore quando si prova a installare o eseguire l'interfaccia della riga di comando di Azure.Since Windows Subsystem for Linux (WSL) is a system call translation layer on top of the Windows platform, you might experience an error when trying to install or run the Azure CLI. L'interfaccia della riga di comando usa alcune funzionalità che potrebbero contenere un bug in WSL.The CLI relies on some features that may have a 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.If you experience an error no matter how you install the CLI, there's a good chance it's an issue with WSL and not with the CLI install process.

Per risolvere i problemi dell'installazione di WSL e possibilmente i problemi riscontrati:To troubleshoot your WSL installation and possibly resolve issues:

  • Se possibile, eseguire un processo di installazione identico in un computer o una VM Linux per verificare se ha esito positivo.If you can, run an identical install process on a Linux machine or VM to see if it succeeds. Se riesce, il problema è quasi certamente correlato a WSL.If it does, your issue is almost certainly related to WSL. Per avviare una VM Linux in Azure, vedere la documentazione su come creare una VM Linux nel portale di Azure.To start a Linux VM in Azure, see the create a Linux VM in the Azure Portal documentation.
  • Verificare di eseguire l'ultima versione di WSL.Make sure that you're running the latest version of WSL. Per ottenere l'ultima versione, aggiornare l'installazione di Windows 10.To get the latest version, update your Windows 10 installation.
  • Verificare la presenza di problemi aperti relativi a WSL che potrebbero risolvere il problema riscontrato.Check for any open issues with WSL which might address your problem. Spesso sono disponibili suggerimenti su soluzioni alternative al problema o informazioni su una versione in cui verrà risolto.Often there will be suggestions on how to work around the problem, or information about a release where the issue will be fixed.
  • 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.If there are no existing issues for your problem, file a new issue with WSL and make sure that you include as much information as possible.

Se i problemi di installazione o esecuzione in WSL persistono, valutare la possibilità di installare l'interfaccia della riga di comando per Windows.If you continue to have issues installing or running on WSL, consider installing the CLI for Windows.

AggiornamentoUpdate

Usare apt-get upgrade per aggiornare il pacchetto dell'interfaccia della riga di comando.Use apt-get upgrade to update the CLI package.

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

Nota

Questo comando aggiorna tutti i pacchetti installati nel sistema che non hanno subito modifiche relative alle dipendenze.This command upgrades all of the installed packages on your system that have not had a dependency change. Per eseguire l'aggiornamento solo dell'interfaccia della riga di comando, usare apt-get install.To upgrade the CLI only, use apt-get install.

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

DisinstallareUninstall

È possibile disinstallare l'interfaccia della riga di comando di Azure.If you decide to uninstall the Azure CLI, we're sorry to see you go. Prima di eseguire la disinstallazione, usare il comando az feedback per segnalare aspetti da migliorare o correggere.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. L'obiettivo è realizzare un'interfaccia della riga di comando di Azure priva di bug e facile da usare.Our goal is to make the Azure CLI bug-free and user-friendly. Se è stato rilevato un bug, segnalarlo in GitHub.If you found a bug, we'd appreciate it if you file a GitHub issue.

  1. Eseguire la disinstallazione con apt-get remove:Uninstall with apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Se non si prevede di reinstallare l'interfaccia della riga di comando di Azure, rimuovere le relative informazioni del repository:If you don't plan to reinstall the CLI, remove the Azure CLI repository information:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Se non si usano altri pacchetti Microsoft, rimuovere la chiave di firma:If you use no other packages from Microsoft, remove the signing key:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.asc.gpg
    
  4. Rimuovere eventuali pacchetti non necessari:Remove any unneeded packages:

    sudo apt autoremove
    

Passaggi successiviNext Steps

Ora che l'interfaccia della riga di comando di Azure è stata installata, passare a una breve presentazione delle relative funzionalità e dei comandi comuni.Now that you've installed the Azure CLI, take a short tour of its features and common commands.