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 :This package has been tested with:

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

La version actuelle de l’interface CLI est la version 2.0.62.The current version of the CLI is 2.0.62. 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

  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 curl apt-transport-https lsb-release gpg
    
  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.

É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.