Installer Azure CLI sur Linux

Nous vous recommandons d’installer Azure CLI à l’aide du gestionnaire de package de votre distribution Linux. Sélectionnez le gestionnaire de package approprié pour votre distribution parmi les options ci-dessus. Si vous n’avez aucun des gestionnaires de package listés, sélectionnez l’option Script d’installation pour installer manuellement Azure CLI.

La version actuelle d’Azure CLI est la version 2.23.0. Pour plus d’informations sur la version la plus récente, consultez les Notes de publication. Pour connaître la version que vous avez installée et savoir si elle nécessite d’être mise à jour, exécutez az version.

Vue d’ensemble

Le gestionnaire de package apt contient un package x86_64 pour Azure CLI qui a été testé sur les distributions suivantes.

Distribution Version
Ubuntu 14.04 LTS (Trusty Tahir), 16.04 LTS (Xenial Xerus), 18.04 LTS (Bionic Beaver), 20.04 LTS (Focal Fossa), 20.10 (Groovy Gorilla)
Debian Debian 8 (Jessie), Debian 9 (Stretch), Debian 10 (Buster)

Avertissement

Ubuntu 20.04 (Focal Fossa) et 20.10 (Groovy Gorilla) incluent un package azure-cli avec la version 2.0.81 fourni par le référentiel universe. Ce package est obsolète et n’est pas recommandé. Si ce package est installé, exécutez la commande sudo apt remove azure-cli -y && sudo apt autoremove -y pour le supprimer avant de continuer.

Le package deb azure-cli ne prend pas en charge l’architecture ARM64.

Options d'installation

Pour installer Azure CLI sur votre système, deux options s’offrent à vous. Vous pouvez soit exécuter une seule commande qui télécharge un script d’installation et exécute les commandes d’installation pour vous, soit exécuter les commandes d’installation vous-même dans un processus pas à pas. Les deux méthodes sont présentées ci-dessous.

Option 1 : Installer avec une seule commande

L’équipe d’Azure CLI propose un script qui permet d’exécuter toutes les commandes d’installation en une seule étape. Ce script, à télécharger avec curl, est dirigé directement vers bash pour installer l’interface CLI.

Si vous souhaitez inspecter le contenu du script avant de l’exécuter, téléchargez-le avec curl et examinez-le dans votre éditeur de texte favori.

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

Option n°2 : Instructions d’installation pas à pas

Si vous préférez suivre un processus d’installation pas à pas, effectuez les étapes suivantes pour installer Azure CLI.

  1. Obtenez les packages nécessaires pour le processus d’installation :

    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 :

    curl -sL https://packages.microsoft.com/keys/microsoft.asc |
        gpg --dearmor |
        sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
    
  3. Ajoutez le référentiel de logiciels Azure CLI :
    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 :

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

Se connecter à Azure avec Azure CLI

Exécutez Azure CLI avec la commande az. Pour vous connecter, utilisez la commande az login.

  1. Exécutez la commande login.

    az login
    

    Si l’interface CLI peut ouvrir votre navigateur par défaut, elle le fait et charge une page de connexion Azure par la même occasion.

    Sinon, ouvrez une page de navigateur à l’adresse https://aka.ms/devicelogin et entrez le code d’autorisation affiché dans votre terminal.

    Si aucun navigateur web n’est disponible ou si l’ouverture du navigateur web échoue, utilisez le flux de code de l’appareil avec az login --use-device-code.

  2. Dans le navigateur, connectez-vous avec les informations d’identification de votre compte.

Pour en savoir plus sur les différentes méthodes d’authentification, consultez Se connecter avec Azure CLI.

Dépannage

Voici certains problèmes courants lors de l’installation avec apt. Si vous rencontrez un problème n’étant pas évoqué ici, signalez un problème sur github.

Aucun problème de module sur Ubuntu 20.04 (Focal)/WSL

Si vous avez installé azure-cli sur Focal sans ajouter le référentiel de logiciels Azure CLI dans l’étape 3 des instructions d’installation manuelle ou si vous utilisez notre script, vous pouvez rencontrer des problèmes tels qu’aucun module nommé « decorator » ou « antlr4 », car le package que vous avez installé est le package azure-cli 2.0.81 obsolète du référentiel focal/universe. Commencez par le supprimer en exécutant sudo apt remove azure-cli -y && sudo apt autoremove -y, puis suivez les instructions ci-dessus pour installer le dernier package azure-cli.

lsb_release ne renvoie pas la bonne version de la distribution de base

Certaines distributions Ubuntu ou Debian dérivées, telles que Linux Mint peuvent ne pas retourner le nom de version correct de lsb_release. Cette valeur est utilisée dans le processus d’installation pour déterminer le package à installer. 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. 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.

Aucun package pour votre 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. Azure CLI est conçu pour résister à de futures versions de dépendances, et repose sur peu d’entre elles. Si aucun package n’est disponible pour votre distribution de base, essayez d’utiliser le package d’une distribution antérieure.

Pour cela, définissez la valeur de AZ_REPO manuellement lors de l’ajout du référentiel. Pour les distributions Ubuntu, utilisez le référentiel bionic, et stretch pour les distributions Debian. Les distributions publiées avant Ubuntu Trusty et Debian Wheezy ne sont pas prises en charge.

Le système d’exploitation élémentaire (EOS, elementary OS) ne parvient pas à installer Azure CLI

EOS ne parvient pas à installer Azure CLI parce que lsb_release retourne HERA, qui est le nom de la version EOS. La solution consiste à corriger le fichier /etc/apt/sources.list.d/azure-cli.list et à remplacer hera main par bionic main.

Contenu du fichier d’origine :

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ hera main

Contenu du fichier modifié

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ bionic main

Le proxy bloque la connexion

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. Vous devez contacter votre administrateur système pour connaître les hôtes et ports à utiliser pour ces proxies.

Ces valeurs sont respectées par de nombreux programmes Linux, notamment ceux qui sont utilisés dans le processus d’installation. Pour obtenir ces valeurs :

# 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. Si vous n’utilisez pas l’authentification de base, il est recommandé d’exporter ces variables dans votre fichier .bashrc. Suivez toujours les stratégies de sécurité de votre entreprise et les exigences de votre administrateur système.

Vous pouvez également configurer de manière explicite apt pour utiliser ce proxy à tout moment. Vérifiez que les lignes suivantes s’affichent dans un fichier de configuration apt dans /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.

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. Si vous avez besoin de plus d’informations sur la configuration du proxy, consultez la documentation officielle Ubuntu :

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 :

  • 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 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. L’interface CLI repose sur certaines fonctionnalités qui peuvent avoir un bogue dans 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.

Pour réussir l’installation de WSL, et potentiellement les problèmes liés :

  • Si possible, employez une méthode d’installation identique sur un appareil ou une machine virtuelle Linux pour voir si cela fonctionne. Le cas échéant, votre problème est probablement lié à WSL. Pour démarrer une machine virtuelle Linux dans Azure, consultez la documentation Créer une machine virtuelle Linux dans le portail Azure.
  • Assurez-vous que vous exécutez la version la plus récente de WSL. Pour obtenir la version la plus récente, mettez à jour votre installation Windows 10.
  • Vérifiez s’il n’y pas déjà des problèmes ouverts pour WSL qui pourraient régler votre problème. 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.
  • 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.

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.

Update

L’interface CLI fournit une commande dans l’outil pour effectuer une mise à jour vers la version la plus récente :

az upgrade

Notes

La commande az upgrade a été ajoutée dans la version 2.11.0 et elle ne fonctionne pas avec les versions antérieures. Les anciennes versions peuvent être mises à jour en les réinstallant, comme décrit dans Installer l’interface Azure CLI.

Cette commande met également à jour toutes les extensions installées par défaut. Pour plus d’options az upgrade, consultez la page de référence des commandes.

Vous pouvez aussi utiliser apt-get upgrade pour mettre à jour le package CLI.

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. Pour mettre à niveau uniquement l’interface CLI, utilisez apt-get install.

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

Désinstaller l’interface

Si vous décidez de désinstaller l’interface de ligne de commande Azure, nous sommes désolés de vous voir partir. Avant de la désinstaller, utilisez la commande az feedback pour nous dire ce qui pourrait être amélioré ou révisé. Notre objectif est de rendre l’interface Azure CLI conviviale et exempte de bogues. Si vous avez rencontré un bogue, nous vous serions reconnaissants de bien vouloir signaler un problème lié à GitHub.

  1. Désinstaller avec 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 :

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Si vous n’utilisez pas d’autres packages de Microsoft, supprimez la clé de signature :

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

    sudo apt autoremove
    

Vue d’ensemble

Pour les distributions Linux avec dnf telles que RHEL, Fedora ou CentOS, il existe un package pour Azure CLI. Ce package a été testé avec RHEL 7.7, RHEL 8, Fedora 24 et versions ultérieures, CentOS 7 et CentOS 8.

La version actuelle d’Azure CLI est la version 2.23.0. Pour plus d’informations sur la version la plus récente, consultez les Notes de publication. Pour connaître la version que vous avez installée et savoir si elle nécessite d’être mise à jour, exécutez az version.

Important

Le package RPM d’Azure CLI dépend du package python3. Sur votre système, il peut s’agir d’une version de Python antérieure à la version imposée, Python 3.6.x. Si cela vous concerne, recherchez un package python3 de remplacement.

N’oubliez pas que Python 2 est arrivé en fin de vie le 1er janvier 2020, et qu’il ne recevra plus de mises à jour. Azure CLI a retiré la prise en charge de Python 2.7 depuis la version 2.1.0. Les nouvelles versions ne garantissent plus une exécution correcte de Python 2.7.

Notes

Utilisez le Gestionnaire de package yum si vous utilisez des systèmes Linux qui ne prennent pas en charge le Gestionnaire de package dnf.

Installer

  1. Importez la clé de référentiel Microsoft.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. Créez des informations de référentiel azure-cli locales.

    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
    
  3. Installez avec la commande dnf install.

    sudo dnf install azure-cli
    

Exécutez Azure CLI avec la commande az. Pour vous connecter, utilisez la commande az login.

  1. Exécutez la commande login.

    az login
    

    Si l’interface CLI peut ouvrir votre navigateur par défaut, elle le fait et charge une page de connexion Azure par la même occasion.

    Sinon, ouvrez une page de navigateur à l’adresse https://aka.ms/devicelogin et entrez le code d’autorisation affiché dans votre terminal.

    Si aucun navigateur web n’est disponible ou si l’ouverture du navigateur web échoue, utilisez le flux de code de l’appareil avec az login --use-device-code.

  2. Dans le navigateur, connectez-vous avec les informations d’identification de votre compte.

Pour en savoir plus sur les différentes méthodes d’authentification, consultez Se connecter avec Azure CLI.

Dépannage

Voici certains problèmes courants lors de l’installation avec dnf. Si vous rencontrez un problème qui n’est pas traité ici, signalez ce problème sur GitHub.

Installer sur RHEL 7.6 ou d’autres systèmes sans Python 3

Si vous le pouvez, mettez à niveau votre système vers une version avec prise en charge officielle du package python 3.6+. Si ce n’est pas possible, vous devrez d’abord installer un package python3, puis installer Azure CLI sans dépendance.

Vous pouvez utiliser la commande suivante pour installer Azure CLI avec python 3.6 généré à partir de la source :

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

Vous pouvez également le faire étape par étape :

Tout d’abord, Azure CLI nécessite SSL 1.1+. En outre, vous devez générer openssl 1.1 à partir de la source avant de générer 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

Ensuite, générez Python 3 à partir de la source :

$ 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

Enfin, suivez les étapes 1 et 2 des instructions d’installation pour ajouter le dépôt Azure CLI. Vous pouvez désormais télécharger le package et l’installer sans dépendance.

Notes

Si vous n’avez pas installé le plug-in dnf download, vous rencontrerez une erreur de commande introuvable lors de l’exécution du code ci-dessous. Utilisez dnf install 'dnf-command(download)' pour installer le plug-in dnf download.

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

En guise d’alternative, vous pouvez également installer Python 3 à l’aide d’un dépôt supplémentaire. Si vous avez configuré python3, mais que vous obtenez toujours une erreur python3: command not found lorsque vous essayez d’exécuter l’interface CLI, vous devez l’ajouter dans votre chemin.

$ scl enable rh-python36 bash

Le proxy bloque la connexion

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. Vous devez contacter votre administrateur système pour connaître les hôtes et ports à utiliser pour ces proxies.

Ces valeurs sont respectées par de nombreux programmes Linux, notamment ceux qui sont utilisés dans le processus d’installation. Pour obtenir ces valeurs :

# 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. Si vous n’utilisez pas l’authentification de base, il est recommandé d’exporter ces variables dans votre fichier .bashrc. Suivez toujours les stratégies de sécurité de votre entreprise et les exigences de votre administrateur système.

Vous pouvez également configurer de manière explicite dnf pour utiliser ce proxy à tout moment. Vérifiez que les lignes suivantes s’affichent sous la section [main] de /etc/dnf/dnf.conf :

[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

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 :

  • 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 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. L’interface CLI repose sur certaines fonctionnalités qui peuvent avoir un bogue dans 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.

Pour réussir l’installation de WSL, et potentiellement les problèmes liés :

  • Si possible, employez une méthode d’installation identique sur un appareil ou une machine virtuelle Linux pour voir si cela fonctionne. Le cas échéant, votre problème est probablement lié à WSL. Pour démarrer une machine virtuelle Linux dans Azure, consultez la documentation Créer une machine virtuelle Linux dans le portail Azure.
  • Assurez-vous que vous exécutez la version la plus récente de WSL. Pour obtenir la version la plus récente, mettez à jour votre installation Windows 10.
  • Vérifiez s’il n’y pas déjà des problèmes ouverts pour WSL qui pourraient régler votre problème. 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.
  • 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.

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.

Update

L’interface CLI fournit une commande dans l’outil pour effectuer une mise à jour vers la version la plus récente :

az upgrade

Notes

La commande az upgrade a été ajoutée dans la version 2.11.0 et elle ne fonctionne pas avec les versions antérieures. Les anciennes versions peuvent être mises à jour en les réinstallant, comme décrit dans Installer l’interface Azure CLI.

Cette commande met également à jour toutes les extensions installées par défaut. Pour plus d’options az upgrade, consultez la page de référence des commandes.

Vous pouvez aussi mettre à jour Azure CLI avec la commande dnf update.

sudo dnf update azure-cli

Désinstaller l’interface

Si vous décidez de désinstaller l’interface de ligne de commande Azure, nous sommes désolés de vous voir partir. Avant de la désinstaller, utilisez la commande az feedback pour nous dire ce qui pourrait être amélioré ou révisé. Notre objectif est de rendre l’interface Azure CLI conviviale et exempte de bogues. Si vous avez rencontré un bogue, nous vous serions reconnaissants de bien vouloir signaler un problème lié à GitHub.

  1. Supprimez le package de votre système.

    sudo dnf remove azure-cli
    
  2. Si vous ne prévoyez pas de réinstaller l’interface CLI, supprimez les informations de référentiel.

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. Si vous n’utilisez pas d’autres packages Microsoft, supprimez la clé de signature.

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

Vue d’ensemble

Pour les distributions Linux avec zypper, telles que openSUSE ou SLES, un package est disponible pour l’Azure CLI. Ce package a été testé avec openSUSE Leap 15.1 and SLES 15.

La version actuelle d’Azure CLI est la version 2.23.0. Pour plus d’informations sur la version la plus récente, consultez les Notes de publication. Pour connaître la version que vous avez installée et savoir si elle nécessite d’être mise à jour, exécutez az version.

Important

Le package RPM d’Azure CLI dépend du package python3. Sur votre système, il peut s’agir d’une version de Python antérieure à la version imposée, Python 3.6.x. Si cela vous concerne, recherchez un package python3 de remplacement.

N’oubliez pas que Python 2 est arrivé en fin de vie le 1er janvier 2020, et qu’il ne recevra plus de mises à jour. Azure CLI a retiré la prise en charge de Python 2.7 depuis la version 2.1.0. Les nouvelles versions ne garantissent plus une exécution correcte de Python 2.7.

Installer

  1. Installez curl :

    sudo zypper install -y curl
    
  2. Importer la clé de référentiel Microsoft :

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  3. Créer des informations de référentiel azure-cli locales :

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
    
  4. Mettre à jour l’index de package zypper et l’installer :

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

    Entrez 2 pour continuer l’installation en ignorant certaines de ses dépendances.

Vous pouvez ensuite exécuter l’interface de ligne de commande Azure avec la commande az. Pour vous connecter, utilisez la commande az login.

  1. Exécutez la commande login.

    az login
    

    Si l’interface CLI peut ouvrir votre navigateur par défaut, elle le fait et charge une page de connexion Azure par la même occasion.

    Sinon, ouvrez une page de navigateur à l’adresse https://aka.ms/devicelogin et entrez le code d’autorisation affiché dans votre terminal.

    Si aucun navigateur web n’est disponible ou si l’ouverture du navigateur web échoue, utilisez le flux de code de l’appareil avec az login --use-device-code.

  2. Dans le navigateur, connectez-vous avec les informations d’identification de votre compte.

Pour en savoir plus sur les différentes méthodes d’authentification, consultez Se connecter avec Azure CLI.

Dépannage

Voici certains problèmes courants lors de l’installation avec zypper. Si vous rencontrez un problème qui n’est pas traité ici, signalez ce problème sur GitHub.

NotImplementedError sur une machine virtuelle OpenSUSE 15

La version 2.0.45 d’Azure CLI est préinstallée sur la machine virtuelle OpenSUSE 15. Cette version est obsolète et présente des problèmes avec az login. Supprimez-la ainsi que ses dépendances avant de suivre les instructions d’installation pour ajouter la dernière version d’Azure CLI :

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

Si vous avez mis à jour Azure CLI sans supprimer les dépendances de la version 2.0.45, ses anciennes dépendances peuvent affecter la version la plus récente d’Azure CLI. Vous devez rajouter l’ancienne version pour établir un lien avec ses dépendances, puis supprimer azure-cli ainsi que ses dépendances :

# 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

Installer sur SLES 12 ou d’autres systèmes sans Python 3.6

Sur SLES 12, le package python3 par défaut est 3.4, qui n’est pas pris en charge par Azure CLI. Vous pouvez d’abord suivre les étapes 1 à 3 des instructions d’installation pour ajouter le dépôt azure-cli. Ensuite, générez une version plus récente de python3 à partir de la source. Enfin, vous pouvez télécharger le package Azure CLI et l’installer sans dépendance.

Vous pouvez utiliser la commande suivante pour installer ou mettre à jour Azure CLI selon les étapes ci-dessus. Le script installe Python 3.8 sous /usr/local/azcli et configure Azure CLI pour l’utiliser en définissant un alias de az avec la valeur PATH=/usr/local/azcli/bin:$PATH az. Vous pouvez également télécharger le script et le modifier en fonction de vos besoins. Par exemple, vous pouvez changer la version de Python ou l’emplacement d’installation.

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

Lors de la première installation, n’oubliez pas d’exécuter la commande suivante pour activer l’alias :

source ~/.bashrc

Le proxy bloque la connexion

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. Vous devez contacter votre administrateur système pour connaître les hôtes et ports à utiliser pour ces proxies.

Ces valeurs sont respectées par de nombreux programmes Linux, notamment ceux qui sont utilisés dans le processus d’installation. Pour obtenir ces valeurs :

# 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. Si vous n’utilisez pas l’authentification de base, il est recommandé d’exporter ces variables dans votre fichier .bashrc. Suivez toujours les stratégies de sécurité de votre entreprise et les exigences de votre administrateur système.

Vous pouvez également configurer de manière explicite zypper (via yast2) pour utiliser ce proxy à tout moment. Pour ce faire, exécutez la commande yast2 proxy en tant que superutilisateur et remplissez les informations présentées dans le formulaire. Si vous avez un gestionnaire de fenêtres disponible sur votre système, vous pouvez également utiliser le volet Network Services > Proxy dans le YaST Control Center.

Pour la configuration avancée ou plus d’informations, consultez la documentation de configuration de proxy OpenSUSE

Pour obtenir la clé de signature Microsoft et obtenir le package à partir de notre dépôt, votre proxy doit autoriser les connexions HTTPS aux adresses suivantes :

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

Échec de l’installation ou de l’exécution de l’interface de ligne de commande sur le sous-système Windows pour 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. L’interface CLI repose sur certaines fonctionnalités qui peuvent avoir un bogue dans 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.

Pour réussir l’installation de WSL, et potentiellement les problèmes liés :

  • Si possible, employez une méthode d’installation identique sur un appareil ou une machine virtuelle Linux pour voir si cela fonctionne. Le cas échéant, votre problème est probablement lié à WSL. Pour démarrer une machine virtuelle Linux dans Azure, consultez la documentation Créer une machine virtuelle Linux dans le portail Azure.
  • Assurez-vous que vous exécutez la version la plus récente de WSL. Pour obtenir la version la plus récente, mettez à jour votre installation Windows 10.
  • Vérifiez s’il n’y pas déjà des problèmes ouverts pour WSL qui pourraient régler votre problème. 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.
  • 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.

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.

Problème de certificat SSL

Lorsqu’un certificat est arrêté ou obsolète sur un ordinateur, vous pouvez recevoir une erreur indiquant que curl n’a pas réussi à vérifier la légitimité du serveur et n’a donc pas pu établir de connexion sécurisée. Mettez à jour votre certificat pour corriger le problème.

sudo zypper update-ca-certificates

Update

L’interface CLI fournit une commande dans l’outil pour effectuer une mise à jour vers la version la plus récente :

az upgrade

Notes

La commande az upgrade a été ajoutée dans la version 2.11.0 et elle ne fonctionne pas avec les versions antérieures. Les anciennes versions peuvent être mises à jour en les réinstallant, comme décrit dans Installer l’interface Azure CLI.

Cette commande met également à jour toutes les extensions installées par défaut. Pour plus d’options az upgrade, consultez la page de référence des commandes.

Vous pouvez aussi mettre à jour le package avec la commande zypper update.

sudo zypper refresh
sudo zypper update azure-cli

Désinstaller l’interface

Si vous décidez de désinstaller l’interface de ligne de commande Azure, nous sommes désolés de vous voir partir. Avant de la désinstaller, utilisez la commande az feedback pour nous dire ce qui pourrait être amélioré ou révisé. Notre objectif est de rendre l’interface Azure CLI conviviale et exempte de bogues. Si vous avez rencontré un bogue, nous vous serions reconnaissants de bien vouloir signaler un problème lié à GitHub.

  1. Supprimez le package de votre système.

    sudo zypper remove -y azure-cli
    
  2. Si vous ne prévoyez pas de réinstaller l’interface CLI, supprimez les informations de référentiel.

    sudo zypper removerepo azure-cli
    
  3. Si vous n’utilisez pas d’autres packages Microsoft, supprimez la clé de signature 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
    

Vue d’ensemble

Notes

Il est fortement recommandé d’installer l’interface CLI avec un gestionnaire de package. Un gestionnaire de package permet de s’assurer que vous obtenez toujours les dernières mises à jour et garantit la stabilité des composants de l’interface CLI. Vérifiez s’il existe un package pour votre distribution avant d’installer manuellement.

L’interface CLI requiert les logiciels suivants :

Important

L’interface CLI a retiré la prise en charge de Python 2.7 depuis la version 2.1.0. Les nouvelles versions ne garantissent plus une exécution correcte de Python 2.7.

Installation ou mise à jour

L’installation et la mise à jour de l’interface CLI nécessitent toutes de réexécuter le script d’installation. Installez l’interface CLI en exécutant curl.

curl -L https://aka.ms/InstallAzureCli | bash

Le script peut également être téléchargé et exécuté localement. Vous devrez peut-être redémarrer votre interpréteur de commandes pour que certaines modifications soient prises en compte.

Vous pouvez ensuite exécuter l’interface de ligne de commande Azure avec la commande az. Pour vous connecter, utilisez la commande az login.

  1. Exécutez la commande login.

    az login
    

    Si l’interface CLI peut ouvrir votre navigateur par défaut, elle le fait et charge une page de connexion Azure par la même occasion.

    Sinon, ouvrez une page de navigateur à l’adresse https://aka.ms/devicelogin et entrez le code d’autorisation affiché dans votre terminal.

    Si aucun navigateur web n’est disponible ou si l’ouverture du navigateur web échoue, utilisez le flux de code de l’appareil avec az login --use-device-code.

  2. Dans le navigateur, connectez-vous avec les informations d’identification de votre compte.

Pour en savoir plus sur les différentes méthodes d’authentification, consultez Se connecter avec Azure CLI.

Dépannage

Voici certains problèmes courants rencontrés pendant une installation manuelle. Si vous rencontrez un problème qui n’est pas traité ici, signalez ce problème sur GitHub.

erreur curl « Objet déplacé »

Si la commande curl renvoie une erreur concernant le -L paramètre ou un message d’erreur indiquant « Objet déplacé », essayez d’utiliser l’URL complète plutôt que la aka.ms redirection :

curl https://azurecliprod.blob.core.windows.net/install | bash

az commande introuvable

Si vous ne pouvez pas exécuter la commande après l’installation et après avoir utilisé bash et zsh, effacez le cache de hachage de commande de votre interpréteur de commandes. Exécuter

hash -r

et vérifiez si le problème est résolu.

Le problème peut également survenir si vous n’avez pas redémarré votre interpréteur de commandes après l’installation. Assurez-vous que l’emplacement de la commande az se trouve dans votre $PATH. L’emplacement de la commande az est

<install path>/bin

Le proxy bloque la connexion

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. Vous devez contacter votre administrateur système pour connaître les hôtes et ports à utiliser pour ces proxies.

Ces valeurs sont respectées par de nombreux programmes Linux, notamment ceux qui sont utilisés dans le processus d’installation. Pour obtenir ces valeurs :

# 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. Si vous n’utilisez pas l’authentification de base, il est recommandé d’exporter ces variables dans votre fichier .bashrc. Suivez toujours les stratégies de sécurité de votre entreprise et les exigences de votre administrateur système.

Pour obtenir les scripts d’installation, votre proxy doit autoriser les connexions HTTPS aux adresses suivantes :

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Points de terminaison utilisés par le gestionnaire de package de votre distribution (le cas échéant) pour les packages de base

Échec de l’installation ou de l’exécution de l’interface de ligne de commande sur le sous-système Windows pour 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. L’interface CLI repose sur certaines fonctionnalités qui peuvent avoir un bogue dans 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.

Pour réussir l’installation de WSL, et potentiellement les problèmes liés :

  • Si possible, employez une méthode d’installation identique sur un appareil ou une machine virtuelle Linux pour voir si cela fonctionne. Le cas échéant, votre problème est probablement lié à WSL. Pour démarrer une machine virtuelle Linux dans Azure, consultez la documentation Créer une machine virtuelle Linux dans le portail Azure.
  • Assurez-vous que vous exécutez la version la plus récente de WSL. Pour obtenir la version la plus récente, mettez à jour votre installation Windows 10.
  • Vérifiez s’il n’y pas déjà des problèmes ouverts pour WSL qui pourraient régler votre problème. 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.
  • 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.

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.

Désinstaller l’interface

Si vous décidez de désinstaller l’interface de ligne de commande Azure, nous sommes désolés de vous voir partir. Avant de la désinstaller, utilisez la commande az feedback pour nous dire ce qui pourrait être amélioré ou révisé. Notre objectif est de rendre l’interface Azure CLI conviviale et exempte de bogues. Si vous avez rencontré un bogue, nous vous serions reconnaissants de bien vouloir signaler un problème lié à GitHub.

Désinstallez l’interface de ligne de commande en supprimant directement les fichiers de l’emplacement spécifié lors de l’installation. L’emplacement d’installation par défaut est $HOME.

  1. Supprimez les fichiers CLI installés.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. Modifiez votre fichier $HOME/.bash_profile pour supprimer la ligne suivante :

    <install location>/lib/azure-cli/az.completion
    
  3. Si vous utilisez bash ou zsh, rechargez le cache de commande de l’interpréteur de commandes.

    hash -r
    

Étapes suivantes

Maintenant que vous avez installé l’interface CLI, découvrez ses fonctionnalités et ses commandes courantes.