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
Importez la clé de référentiel Microsoft.
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
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
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.
Pour voir les versions disponibles avec la commande :
dnf list --showduplicates azure-cli
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.
Supprimez le package de votre système.
sudo dnf remove azure-cli
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
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 :
Utilisez le package Enterprise fourni par SUSE dans les dépôts SUSE/OpenSUSE.
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)
Installez
curl
:sudo zypper install -y curl
Importer la clé de référentiel Microsoft :
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
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
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.
Consultez les versions disponibles en utilisant cette commande :
zypper search --details --match-exact azure-cli
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.
Supprimez le package de votre système.
sudo zypper remove -y azure-cli
Si vous ne prévoyez pas de réinstaller l’interface CLI, supprimez les informations de référentiel.
sudo zypper removerepo azure-cli
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.
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
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
- 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
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.
Pour voir les versions disponibles avec la commande :
apt-cache policy azure-cli
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 :
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.
Désinstaller avec
apt-get remove
:sudo apt-get remove -y azure-cli
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
Si vous n’utilisez pas d’autres packages de Microsoft, supprimez la clé de signature :
sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg
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 :
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
.
Supprimez les fichiers CLI installés.
rm -r <install location>/lib/azure-cli rm <install location>/bin/az
Modifiez votre fichier
$HOME/.bash_profile
pour supprimer la ligne suivante :<install location>/lib/azure-cli/az.completion
Si vous utilisez
bash
ouzsh
, 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.