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 64 bits est disponible pour Azure CLI.If you are running a distribution that comes with apt, such as Ubuntu or Debian, there's a 64-bit 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

InstallerInstall

  1. Installez les packages prérequis :Install prerequisite packages:

    sudo apt-get install apt-transport-https lsb-release software-properties-common dirmngr -y
    
  2. Modifiez votre liste de sources :Modify your sources list:
    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
    
  3. Obtenir la clé de signature Microsoft :Get the Microsoft signing key:
    sudo apt-key --keyring /etc/apt/trusted.gpg.d/Microsoft.gpg adv \
         --keyserver packages.microsoft.com \
         --recv-keys BC528686B50D79E339D3721CEB3E94ADBE1229CF
    
  4. Installer l’interface de ligne de commande :Install the CLI:

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

    Avertissement

    La clé de signature a été mise à jour en mai 2018 et a été remplacée.The signing key was updated in May 2018, and has been replaced. Si vous recevez des erreurs de signature, veillez à disposer de la dernière clé de signature.If you receive signing errors, make sure you have the latest signing key.

Vous pouvez ensuite exécuter l’interface de ligne de commande Azure avec la commande az.You can then run the Azure CLI with the az command. Pour vous connecter, utilisez la commande az login.To sign in, use 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 la version dont votre distribution est dérivée, vous pouvez définir la valeur AZ_REPO manuellement à l’étape 2 de l’installation.If you know the name of the version your distribution is derived from, you can set the AZ_REPO value manually in install step 2. Dans le cas contraire, recherchez des informations concernant votre distribution, sur la façon de déterminer le nom de la distribution de base et de définir AZ_REPO sur la valeur correcte.Otherwise, look up information for your distribution on how to determine the base distribution name and set AZ_REPO to the correct value.

Aucun package pour votre distributionNo package for your distribution

La disponibilité d’un package Azure CLI pour une distribution Ubuntu après sa publication peut parfois prendre un certain temps.Sometimes it may be a while after an Ubuntu distribution is released before there's an Azure CLI package made 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 ce faire, définissez manuellement la valeur de AZ_REPO dans étape 1 Installer.To do this, set the value of AZ_REPO manually in install step 1. 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.

Clé apt échoue avec le message « No dirmngr »apt-key fails with "No dirmngr"

Lorsque vous exécutez la commande apt-key, vous pouvez voir une sortie similaire à l’erreur suivante :When running the apt-key command, you may see output similar to the following error:

gpg: failed to start the dirmngr '/usr/bin/dirmngr': No such file or directory
gpg: connecting dirmngr at '/tmp/apt-key-gpghome.kt5zo27tp1/S.dirmngr' failed: No such file or directory
gpg: keyserver receive failed: No dirmngr

Cette erreur est due à un composant manquant requis par apt-key.The error is due to a missing component required by apt-key. Vous pouvez résoudre ce problème en installant le package dirmngr.You can resolve it by installing the dirmngr package.

sudo apt-get install dirmngr

Si vous êtes sur le sous-système Windows pour Linux (WSL), cette erreur apparaît également sur les versions de Windows antérieures à Windows 10 1809.If you are on Windows Subsystem for Linux (WSL), this error also appears on versions of Windows prior to Windows 10 1809. Pour résoudre ce problème, mettez à jour votre version de Windows.To resolve the issue, update your version of Windows.

apt-key se bloqueapt-key hangs

Lorsqu’un pare-feu bloque les connexions sortantes au port 11371, la commande apt-key peut se bloquer indéfiniment.When behind a firewall blocking outgoing connections to port 11371, the apt-key command might hang indefinitely. Votre pare-feu peut nécessiter l’utilisation d’un proxy HTTP pour les connexions sortantes :Your firewall may require an HTTP proxy for outgoing connections:

sudo apt-key --keyring /etc/apt/trusted.gpg.d/Microsoft.gpg adv \
    --keyserver-options http-proxy=http://<USER>:<PASSWORD>@<PROXY-HOST>:<PROXY-PORT>/ \
    --keyserver packages.microsoft.com \
    --recv-keys BC528686B50D79E339D3721CEB3E94ADBE1229CF

Pour vous assurer que vous disposez d’un proxy, contactez votre administrateur système.To determine if you have a proxy, contact your system administrator. Si votre proxy ne nécessite pas de connexion, ignorez les informations d’utilisateur et de mot de passe.If your proxy does not require a login, then leave out the user and password information.

É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

Avertissement

La clé de signature a été mise à jour en mai 2018 et a été remplacée.The signing key was updated in May 2018, and has been replaced. Si vous recevez des erreurs de signature, veillez à disposer de la dernière clé de signature.If you receive signing errors, make sure you have the latest signing key.

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