Installer Azure CLI avec aptInstall Azure CLI with apt

Si vous exécutez une distribution qui est fournie avec apt, telle que Ubuntu ou Debian, un package x86_64 est disponible pour Azure CLI.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. Ce package a été testé avec les systèmes pris en charge suivants :This package has been tested with and is supported for:

  • Ubuntu trusty, xenial, artful, bionic et discoUbuntu trusty, xenial, artful, bionic, and disco
  • Debian wheezy, jessie, et stretchDebian wheezy, jessie, and stretch

La version actuelle d’Azure CLI est 2.0.73.The current version of the Azure CLI is 2.0.73. Pour plus d’informations sur la version la plus récente, consultez les Notes de publication.For information about the latest release, see the release notes. Pour connaître la version que vous avez installée et savoir si elle nécessite d’être mise à jour, exécutez az --version.To find your installed version and see if you need to update, run az --version.

Notes

Le package Azure CLI installe son propre interpréteur Python et n’utilise pas le système Python.The package for Azure CLI installs its own Python interpreter, and does not use the system Python.

InstallerInstall

Pour installer Azure CLI avec les distributions prenant en charge apt, vous pouvez soit utiliser un script tout-en-un qui exécute les commandes d’installation pour vous, soit suivre vous-même les instructions d’un processus étape par étape.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.

Installer avec une seule commandeInstall with one command

Nous vous proposons un script à jour qui exécute toutes les commandes d’installation en une seule étape.We offer and maintain a script which runs all of the installation commands in one step. Pour l’exécuter, utilisez le pipe pour associer curl directement à bash, ou téléchargez le script dans un fichier et vérifiez-le avant de l’exécuter.Run it by using curl and pipe directly to bash, or download the script to a file and inspect it before running.

Important

Ce script a été uniquement validé sur Ubuntu 16.04 et Debian 8+.This script is only verified for Ubuntu 16.04+ and Debian 8+. Il est possible qu’il ne fonctionne pas sur d’autres distributions.It may not work on other distributions. Si vous utilisez une distribution dérivée telle que Linux Mint, suivez les instructions d’installation manuelle et effectuez les opérations de dépannage nécessaires.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

Instructions d’installation manuelleManual install instructions

Si vous ne souhaitez pas exécuter un script en tant que superutilisateur ou que le script tout-en-un échoue, suivez ces étapes pour installer Azure CLI.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. Récupérez les packages nécessaires au processus d’installation :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. Téléchargez et installez la clé de signature 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. Ajoutez le référentiel de logiciels Azure CLI :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. Mettez à jour les informations concernant le référentiel, puis installez le package azure-cli :Update repository information and install the azure-cli package:

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

Exécutez Azure CLI avec la commande az.Run the Azure CLI with the az command. Pour vous connecter, utilisez la commande az login.To sign in, use the az login command.

  1. Exécutez la commande login.Run the login command.

    az login
    

    Si l’interface CLI peut ouvrir votre navigateur par défaut, elle le fera et chargera une page de connexion par la même occasion.If the CLI can open your default browser, it will do so and load a sign-in page.

    Sinon, vous devez ouvrir une page de navigateur et suivre les instructions sur la ligne de commande pour entrer un code d’autorisation après avoir accédé à https://aka.ms/devicelogin dans votre navigateur.Otherwise, you need to open a browser page and follow the instructions on the command line to enter an authorization code after navigating to https://aka.ms/devicelogin in your browser.

  2. Dans le navigateur, connectez-vous avec les informations d’identification de votre compte.Sign in with your account credentials in the browser.

Pour en savoir plus sur les différentes méthodes d’authentification, consultez Se connecter avec Azure CLI.To learn more about different authentication methods, see Sign in with Azure CLI.

Résolution de problèmesTroubleshooting

Voici certains problèmes courants lors de l’installation avec apt.Here are some common problems seen when installing with apt. Si vous rencontrez un problème n’étant pas évoqué ici, signalez un problème sur github.If you experience a problem not covered here, file an issue on github.

lsb_release ne renvoie pas la bonne version de la distribution de baselsb_release does not return the correct base distribution version

Certaines distributions Ubuntu ou Debian dérivées, telles que Linux Mint peuvent ne pas retourner le nom de version correct de lsb_release.Some Ubuntu- or Debian-derived distributions such as Linux Mint may not return the correct version name from lsb_release. Cette valeur est utilisée dans le processus d’installation pour déterminer le package à installer.This value is used in the install process to determine the package to install. Si vous connaissez le nom de code de la version Ubuntu ou Debian dont votre distribution est dérivée, vous pouvez définir la valeur AZ_REPO manuellement lors de l’ajout du référentiel.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. Dans le cas contraire, recherchez des informations expliquant comment déterminer le nom de code de la distribution de base et définir AZ_REPO sur la valeur appropriée.Otherwise, look up information for your distribution on how to determine the base distribution code name and set AZ_REPO to the correct value.

Aucun package pour votre distributionNo package for your distribution

Après la publication d’une distribution, il peut se passer un certain temps avant que le package Azure CLI associé ne soit disponible.Sometimes it may be a while after a distribution is released before there's an Azure CLI package available for it. Azure CLI est conçu pour résister à de futures versions de dépendances, et repose sur peu d’entre elles.The Azure CLI designed to be resilient with regards to future versions of dependencies and rely on as few of them as possible. Si aucun package n’est disponible pour votre distribution de base, essayez d’utiliser le package d’une distribution antérieure.If there's no package available for your base distribution, try a package for an earlier distribution.

Pour cela, définissez la valeur de AZ_REPO manuellement lors de l’ajout du référentiel.To do this, set the value of AZ_REPO manually when adding the repository. Pour les distributions Ubuntu, utilisez le référentiel bionic, et stretch pour les distributions Debian.For Ubuntu distributions use the bionic repository, and for Debian distributions use stretch. Les distributions publiées avant Ubuntu Trusty et Debian Wheezy ne sont pas prises en charge.Distributions released before Ubuntu Trusty and Debian Wheezy are not supported.

Le proxy bloque la connexionProxy blocks connection

Si vous ne parvenez pas à vous connecter à une ressource externe en raison d’un proxy, vérifiez que vous avez correctement défini les variables HTTP_PROXY et HTTPS_PROXY dans votre interpréteur de commandes.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. Vous devez contacter votre administrateur système pour connaître les hôtes et ports à utiliser pour ces proxies.You will need to contact your system administrator to know what host(s) and port(s) to use for these proxies.

Ces valeurs sont respectées par de nombreux programmes Linux, notamment ceux qui sont utilisés dans le processus d’installation.These values are respected by many Linux programs, including those which are used in the install process. Pour obtenir ces valeurs :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]

Important

Si vous vous trouvez derrière un proxy, ces variables d’interpréteur de commandes doivent être définies pour se connecter aux services Azure avec l’interface CLI.If you are behind a proxy, these shell variables must be set to connect to Azure services with the CLI. Si vous n’utilisez pas l’authentification de base, il est recommandé d’exporter ces variables dans votre fichier .bashrc.If you are not using basic auth, it's recommended to export these variables in your .bashrc file. Suivez toujours les stratégies de sécurité de votre entreprise et les exigences de votre administrateur système.Always follow your business' security policies and the requirements of your system administrator.

Vous pouvez également configurer de manière explicite apt pour utiliser ce proxy à tout moment.You may also want to explicitly configure apt to use this proxy at all times. Vérifiez que les lignes suivantes s’affichent dans un fichier de configuration apt dans /etc/apt/apt.conf.d/.Make sure that the following lines appear in an apt configuration file in /etc/apt/apt.conf.d/. Nous vous recommandons d’utiliser votre fichier de configuration global existant, un fichier de configuration de proxy existant, 40proxies ou 99local. Mais suivez vos besoins d’administration système.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]";
}

Si votre proxy n’utilise pas l’authentification de base, supprimez la partie [username]:[password]@ de l’URI du proxy.If your proxy does not use basic auth, remove the [username]:[password]@ portion of the proxy URI. Si vous avez besoin de plus d’informations sur la configuration du proxy, consultez la documentation officielle Ubuntu :If you require more information for proxy configuration, see the official Ubuntu documentation:

Pour obtenir la clé de signature Microsoft et obtenir le package à partir de notre dépôt, votre proxy doit autoriser les connexions HTTPS à l’adresse suivante :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

Échec de l’installation ou de l’exécution de l’interface de ligne de commande sur le sous-système Windows pour LinuxCLI fails to install or run on Windows Subsystem for Linux

Dans la mesure où le sous-système Windows pour Linux (WSL) est une couche de traduction d’appel système, sur la plateforme Windows, il se peut que vous rencontriez une erreur lors de l’installation ou de l’exécution d’Azure CLI.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’interface CLI repose sur certaines fonctionnalités qui peuvent avoir un bogue dans WSL.The CLI relies on some features that may have a bug in WSL. Si vous rencontrez une erreur, quelle que soit votre méthode d’installation de l’interface CLI, il y a des chances que l’erreur vienne de WSL et non de la méthode d’installation de l’interface CLI.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.

Pour réussir l’installation de WSL, et potentiellement les problèmes liés :To troubleshoot your WSL installation and possibly resolve issues:

  • Si possible, employez une méthode d’installation identique sur un appareil ou une machine virtuelle Linux pour voir si cela fonctionne.If you can, run an identical install process on a Linux machine or VM to see if it succeeds. Le cas échéant, votre problème est probablement lié à WSL.If it does, your issue is almost certainly related to WSL. Pour démarrer une machine virtuelle Linux dans Azure, consultez la documentation Créer une machine virtuelle Linux dans le portail Azure.To start a Linux VM in Azure, see the create a Linux VM in the Azure Portal documentation.
  • Assurez-vous que vous exécutez la version la plus récente de WSL.Make sure that you're running the latest version of WSL. Pour obtenir la version la plus récente, mettez à jour votre installation Windows 10.To get the latest version, update your Windows 10 installation.
  • Vérifiez s’il n’y pas déjà des problèmes ouverts pour WSL qui pourraient régler votre problème.Check for any open issues with WSL which might address your problem. Vous trouverez le plus souvent des conseils pour contourner le problème, ou des informations relatives à une future version qui règlera le problème.Often there will be suggestions on how to work around the problem, or information about a release where the issue will be fixed.
  • S’il n’y a rien au sujet de votre problème, renseignez un nouveau problème avec WSL et veillez à inclure le plus d’informations possible.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.

Si vous rencontrez de nouveau des problèmes d’installation ou d’exécution sur WSL, vous devrez peut-être installer l’interface CLI pour Windows.If you continue to have issues installing or running on WSL, consider installing the CLI for Windows.

Mettre à jourUpdate

Utilisez apt-get upgrade pour mettre à jour le package de l’interface de ligne de commande.Use apt-get upgrade to update the CLI package.

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

Notes

Cette commande met à niveau tous les packages installés sur votre système n’ayant pas de modification de dépendance.This command upgrades all of the installed packages on your system that have not had a dependency change. Pour mettre à niveau uniquement l’interface CLI, utilisez 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

Désinstaller l’interfaceUninstall

Si vous décidez de désinstaller l’interface de ligne de commande Azure, nous sommes désolés de vous voir partir.If you decide to uninstall the Azure CLI, we're sorry to see you go. Avant de la désinstaller, utilisez la commande az feedback pour nous dire ce qui pourrait être amélioré ou révisé.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. Notre objectif est de rendre l’interface Azure CLI conviviale et exempte de bogues.Our goal is to make the Azure CLI bug-free and user-friendly. Si vous avez rencontré un bogue, nous vous serions reconnaissants de bien vouloir signaler un problème lié à GitHub.If you found a bug, we'd appreciate it if you file a GitHub issue.

  1. Désinstaller avec apt-get remove :Uninstall with apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Si vous ne prévoyez pas de réinstaller l’interface CLI, supprimez les informations de référentiel Azure CLI :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. Supprimer la clé de signature :Remove the signing key:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.asc.gpg
    
  4. Supprimer tous les packages inutiles :Remove any unneeded packages:

    sudo apt autoremove
    

Étapes suivantesNext Steps

Maintenant que vous avez installé l’interface CLI, découvrez ses fonctionnalités et ses commandes courantes.Now that you've installed the Azure CLI, take a short tour of its features and common commands.