Installer Azure CLI sur Linux

Azure CLI est un outil en ligne de commande multiplateforme que vous pouvez installer localement sur des ordinateurs Linux. Vous pouvez utiliser Azure CLI sur Linux pour vous connecter à Azure et exécuter des commandes d’administration sur des ressources Azure. Azure CLI sur Linux vous permet d’exécuter diverses commandes par le biais d’un terminal à l’aide d’invites de ligne de commande interactives ou d’un script. Quand vous êtes prêt à installer Azure CLI sur Linux, il est recommandé d’utiliser un gestionnaire de package de distribution Linux. Sélectionnez le gestionnaire de package approprié pour votre distribution parmi les options ci-dessus. Si vous ne disposez d’aucun des gestionnaires de package listés, sélectionnez l’option Script d’installation pour installer manuellement Azure CLI sur Linux.

La version actuelle d’Azure CLI est la version 2.44.1. 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

Pour les distributions Linux avec dnf comme RHEL 8/9 ou CentOS Stream 8/9, des packages RPM sont disponibles pour Azure CLI.

Avertissement

À partir d’Azure CLI 2.39.0 (publiée le 02/08/2022), aucun package RPM n’est publié pour RHEL 7 et CentOS 7. Vous pouvez continuer à utiliser des versions de l’historique d’Azure CLI sur ces systèmes, mais il n’y aura aucune mise à jour ni aucun correctif. Envisagez d’effectuer une mise à niveau vers des versions plus récentes de RHEL ou de CentOS pour utiliser la dernière version d’Azure CLI.

La version actuelle d’Azure CLI est la version 2.44.1. 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 a atteint sa fin de vie (EOL) le 1er janvier 2020 et qu’il ne reçoit plus de mises à jour. Azure CLI a retiré la prise en charge de Python 2.7 depuis la version 2.1.0. Nous ne garantissons plus que les nouvelles versions s’exécutent correctement avec 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. Pour RHEL 9 ou CentOS Stream 9, ajoutez un référentiel packages-microsoft-com-prod :

   sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm
   

   Pour RHEL 8 ou CentOS Stream 8, ajoutez un référentiel packages-microsoft-com-prod :

   sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
   

   Pour RHEL 7 ou CentOS 7, ajoutez un référentiel azure-cli :

   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
   

Installer une version spécifique

Vous devez d’abord configurer les informations du dépôt azure-cli comme indiqué ci-dessus. Vous trouverez les versions disponibles dans Notes de publication Azure CLI.

1. Pour voir les versions disponibles avec la commande :

   dnf list --showduplicates azure-cli
   

2. Pour installer une version spécifique :

   sudo dnf install azure-cli-<version>-1.el7
   

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
   

Avertissement

Le dernier package Azure CLI développé par Microsoft pour SUSE Linux Enterprise Server (SLES) et OpenSUSE (Leap) est la version 2.39.0 (publiée le 02/08/2022). Vous pouvez continuer à utiliser les versions historiques d’Azure CLI sur ces systèmes, mais Microsoft ne publiera plus de mises à jour ni de correctifs pour ces versions.

Azure CLI et le script d’installation Linux continueront d’être développés et pris en charge par Microsoft. Les packages fournis par les dépôts SUSE/OpenSUSE sont gérés et pris en charge par SUSE.

Vue d’ensemble

Dans Azure, les machines virtuelles SUSE et OpenSUSE basées sur les images Place de marché Azure ont déjà l’interface de ligne de commande Azure (Azure CLI) installée.

Pour installer Azure CLI sur SUSE/OpenSUSE, choisissez l’une des méthodes suivantes :

1. Utilisez le package Enterprise fourni par SUSE dans les dépôts SUSE/OpenSUSE.

2. Utilisez la méthode d’installation décrite sous l’onglet « Installer le script (n’importe lequel) ».

Installation de l’interface de ligne de commande Azure

Installer à partir de dépôts SUSE ou OpenSUSE

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 a atteint sa fin de vie (EOL) le 1er janvier 2020 et qu’il ne reçoit plus de mises à jour. Azure CLI a retiré la prise en charge de Python 2.7 depuis la version 2.1.0. Nous ne garantissons plus que les nouvelles versions s’exécutent correctement avec Python 2.7.

sudo zypper install -y azure-cli

Installer avec le script d’installation

Vous pouvez installer manuellement Azure CLI sur n’importe quelle version de Linux avec l’option Installer le script.

Si vous faites la mise à jour vers la version la plus récente en utilisant cette méthode, veillez à désinstaller d’abord la version précédente, ainsi que tous les dépôts que vous avez ajoutés pour cette version.

Installer à partir de dépôts Microsoft

Pour installer la version historique la plus récente d’Azure CLI en utilisant des dépôts Microsoft, suivez ces étapes.

(Ce package a été testé avec SLES 15 et OpenSUSE Leap 15.1)

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.

Installer une version spécifique

Vous devez d’abord configurer les informations du dépôt azure-cli comme indiqué ci-dessus. Les versions disponibles sont indiquées dans les Notes de publication d’Azure CLI.

1. Consultez les versions disponibles en utilisant cette commande :

   zypper search --details --match-exact azure-cli
   

2. Pour installer une version spécifique :

   sudo zypper install --from azure-cli azure-cli=<version>-1.el7
   

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 machine virtuelle OpenSUSE 15 est préinstallée avec Azure CLI version 2.0.45, qui est obsolète et a des problèmes avec az login. Supprimez cette version 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 dernière version 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 az sur 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 toujours utiliser ce proxy. 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 sur les 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

Quand un certificat est arrêté ou obsolète sur une machine, vous pouvez recevoir une erreur indiquant que curl n’a pas pu 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

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

Distribution	Version
Ubuntu	18.04 LTS (Bionic Beaver), 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish)
Debian	10 (Buster), 11 (Bullseye)

Avertissement

Vous pouvez continuer à utiliser des versions de l’historique d’Azure CLI sur les anciens systèmes, mais il n’y aura aucune mise à jour ni aucun correctif. Envisagez une mise à niveau vers des versions plus récentes d’Ubuntu ou de Debian pour utiliser la dernière version d’Azure CLI.

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. Consultez Gestion des packages Ubuntu ou Demandez à Ubuntu pour obtenir plus d’informations sur apt remove.

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 :

   sudo mkdir -p /etc/apt/keyrings
   curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
       gpg --dearmor |
       sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null
   sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
   

3. Ajoutez le référentiel de logiciels Azure CLI :

   AZ_REPO=$(lsb_release -cs)
   echo "deb [arch=`dpkg --print-architecture` signed-by=/etc/apt/keyrings/microsoft.gpg] 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
   

Installer une version spécifique

Vous devez d’abord configurer les informations du dépôt azure-cli comme indiqué ci-dessus. Vous trouverez les versions disponibles dans Notes de publication Azure CLI.

1. Pour voir les versions disponibles avec la commande :

   apt-cache policy azure-cli
   

2. Pour installer une version spécifique :

   sudo apt-get install azure-cli=<version>-1~bullseye
   

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 dernier dépôt jammy :

AZ_REPO="jammy"

Pour les distributions Debian, utilisez le dernier dépôt bullseye :

AZ_REPO="bullseye"

Les distributions publiées avant Ubuntu Bionic et Debian Buster 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 :

• apt.conf manpage
• Ubuntu wiki - apt-get howto

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

Des packages RPM sont publiés pour CBL-Mariner 2.0.

Installer

Effectuez l’installation avec la commande tdnf install :

sudo tdnf install azure-cli

Installer une version spécifique

Vous trouverez les versions disponibles dans Notes de publication Azure CLI.

Pour voir les versions disponibles avec la commande :

tdnf list azure-cli

Pour installer une version spécifique :

sudo tdnf install azure-cli-<version>-1

Update

Mettez à jour Azure CLI avec la commande tdnf update :

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

Supprimez le package de votre système :

sudo tdnf remove azure-cli

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 :

• Python 3.6.x, 3.7.x ou 3.8.x.
• libffi
• OpenSSL 1.0.2

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.

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
   

Supprimer les données

Si vous n’envisagez pas de réinstaller Azure CLI, supprimez ses données.

rm -rf ~/.azure

Étapes suivantes

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

Prise en main de l’interface Azure CLI