Installer Azure CLI sur Linux

  • Article

Cet article explique comment installer le Azure CLI sur Linux. Sélectionnez le gestionnaire de package approprié pour votre distribution dans les options en haut de la page. Il est recommandé d’utiliser le gestionnaire de package d’une distribution Linux, mais vous pouvez installer manuellement Azure CLI sur Linux en sélectionnant l’option Installer le script.

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

Avant de commencer

  • Azure CLI 2.38.1 (publié le 01 septembre 2023) est la dernière version prise en charge sur RHEL 7 et Centos 7 et continuera de recevoir des correctifs de sécurité jusqu’à la fin de vie des systèmes d’exploitation. Microsoft ne fournit pas d’autres mises à jour ou correctifs de bogues pour ces distributions.

  • Microsoft continue de développer et de prendre en charge Azure CLI et le script d’installation Linux.

  • Utilisez le gestionnaire de package yum si vous utilisez un système Linux qui ne prend pas en charge le gestionnaire de package dnf.

Installation de l’interface de ligne de commande Azure

Pour installer l’interface de ligne de commande Azure, procédez comme suit :

  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

Mettre à jour Azure CLI

À compter de la version 2.11.0, Azure CLI fournit une commande dans l’outil pour effectuer la mise à jour vers la dernière version.

az upgrade

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. Pour les versions d’Azure CLI antérieures à 2.11.0, mettez à jour en réinstallant comme décrit dans Installer Azure CLI.

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

sudo dnf update azure-cli

Désinstaller Azure CLI

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

Supprimer les données

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

rm -rf ~/.azure

Résolution des problèmes

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 offrant une 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 télécharger et installer le script d’installation 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 référentiel Azure CLI. Vous pouvez désormais télécharger le package et l’installer sans dépendance.

Remarque

Si le plug-in de téléchargement DNF n’est pas déjà installé, une erreur command not found survient lors de l’exécution du code suivant. 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

Vous pouvez également installer Python 3 à l’aide d’un autre référentiel. Utilisez cette méthode si vous avez configuré python3 mais que vous obtenez toujours l’erreur python3: command not found. Assurez-vous qu’il est inclus 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.

Les valeurs de ces variables sont utilisées par de nombreux programmes Linux et pendant 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 toujours utiliser ce proxy. 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 pouvoir récupérer la clé de signature Microsoft et le package dans notre référentiel, 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. Il y a souvent des suggestions sur la manière de contourner le problème, ou des informations sur une version où le problème est corrigé.
  • 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.

Avant de commencer

  • Azure CLI 2.38.1 (publié le 01 septembre 2023) est la dernière version prise en charge sur SUSE Linux Enterprise Server (SLES) et OpenSUSE (Leap) et continuera à recevoir des correctifs de sécurité jusqu’à la fin de juin 2024. Microsoft ne fournit pas d’autres mises à jour ou correctifs de bogues pour ces distributions.

  • Microsoft continue de développer et de prendre en charge Azure CLI et le script d’installation Linux. SUSE gère et prend en charge les packages fournis par les référentiels SUSE/OpenSUSE.

  • Dans Azure, les machines virtuelles SUSE et OpenSUSE basées sur les images Place de marché Azure ont déjà Azure CLI installée.

Installation de l’interface de ligne de commande Azure

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

  3. Installer à partir de référentiels Microsoft

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

Le package RPM d’Azure CLI dépend du package python3.

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, et 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

Mettre à jour Azure CLI

À compter de la version 2.11.0, Azure CLI fournit une commande dans l’outil pour effectuer la mise à jour vers la dernière version.

az upgrade

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. Pour les versions d’Azure CLI antérieures à 2.11.0, mettez à jour en réinstallant comme décrit dans Installer Azure CLI.

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

sudo zypper refresh
sudo zypper update azure-cli

Désinstaller Azure CLI

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

Supprimer les données

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

rm -rf ~/.azure

Résolution des problèmes

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.

Installer sans Python 3

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. Les versions plus récentes du CLI peuvent ne pas s’exécuter correctement à l’aide de Python 2.7.

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.

Les valeurs de ces variables sont utilisées par de nombreux programmes Linux et pendant 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. Il y a souvent des suggestions sur la manière de contourner le problème, ou des informations sur une version où le problème est corrigé.
  • 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

Avant de commencer

  • Le gestionnaire de package apt contient des packages x86_64 et ARM64 pour Azure CLI qui ont été testés sur les distributions suivantes.

    Distribution Version
    Ubuntu 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish)
    Debian 10 (Buster), 11 (Bullseye), 12 (Bookworm)

  • 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. Pour plus d’informations sur apt remove, consultez la gestion des packages Ubuntu ou demandez à ubuntu.

Installation de l’interface de ligne de commande Azure

Pour installer Azure CLI sur votre système, deux options s’offrent à vous. Vous pouvez télécharger un script d’installation qui exécutera les commandes d’installation, ou bien exécuter ces commandes vous-même dans un processus pas à pas. Les deux méthodes sont présentées ici :

Option 1 : Installer avec une seule commande

Le moyen le plus simple d’installer Azure CLI consiste à utiliser un script géré par l’équipe Azure CLI. Ce script exécute 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 au processus d'installation :

    sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release

  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 |
  sudo gpg --dearmor -o /etc/apt/keyrings/microsoft.gpg
sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
  3. Ajoutez le référentiel de logiciels Azure CLI : 
    AZ_DIST=$(lsb_release -cs)
echo "Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: ${AZ_DIST}
Components: main
Architectures: $(dpkg --print-architecture)
Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources

  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. Affichez les versions disponibles d’Azure CLI.

    apt-cache policy azure-cli

  2. Installez une version spécifique.

    # Obtain the currently installed distribution
AZ_DIST=$(lsb_release -cs)

# Store an Azure CLI version of choice
AZ_VER=2.51.0

# Install a specific version
sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}

    Pour installer une version spécifique sans variables, remplacez la version d’Azure CLI et le nom de la distribution Linux indiqués :

    sudo apt-get install azure-cli=2.51.0-1~bullseye

Si vous recevez un message d’erreur Impossible de localiser le package azure-cli, les informations du référentiel azure-cli ne sont pas configurées. Effectuez les étapes indiquées dans Option 2 : instructions d’installation pas à pas.

Si vous recevez un message d’erreur Version x.xx.x-1~distributionName pour azure-cli est introuvable, utilisez lsb_release -cs pour trouver la distribution que vous exécutez.

Mettre à jour Azure CLI

À compter de la version 2.11.0, Azure CLI fournit une commande dans l’outil pour effectuer la mise à jour vers la dernière version.

az upgrade

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. Pour les versions d’Azure CLI antérieures à 2.11.0, mettez à jour en réinstallant comme décrit dans Installer Azure CLI.

Vous pouvez aussi utiliser apt-get upgrade pour mettre à jour le package CLI. Cette commande met à niveau tous les packages installés sur votre système n’ayant pas de modification de dépendance.

sudo apt-get update && sudo apt-get upgrade

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 Azure CLI

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

  3. Si vous n’utilisez pas d’autres packages de Microsoft, supprimez la clé de signature :

    sudo rm /etc/apt/keyrings/microsoft.gpg

  4. Supprimer tous les packages inutiles :

    sudo apt autoremove

Supprimer les données

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

rm -rf ~/.azure

Résolution des problèmes

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

Le package azure-cli prend en charge l’architecture ARM64 à partir de la version CLI 2.46.0.

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 dérivées de Debian (par exemple Linux Mint) ne retournent pas le bon nom de version à partir 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 d’Ubuntu ou de Debian dont votre distribution est dérivée, vous pouvez définir manuellement la valeur AZ_REPO 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

Parfois, un package Azure CLI mis à jour n’est pas disponible immédiatement après la publication d’une version de distribution. Azure CLI est conçu pour offrir de la résilience avec les futures versions des dépendances et s’appuyer sur le moins possible 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 essayer un package pour une distribution antérieure, définissez manuellement la valeur de AZ_REPO lors de l’ajout du dépôt. Pour les distributions Ubuntu, utilisez le dernier dépôt jammy :

AZ_REPO="jammy"

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

AZ_REPO="bookworm"

Important

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.sources et à remplacer Suites: hera par Suites: bionic.

Contenu du fichier d’origine :

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Contenu du fichier modifié

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

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.

Les valeurs de ces variables sont utilisées par de nombreux programmes Linux et pendant 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 toujours utiliser ce proxy. 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 référentiel, 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. Il y a souvent des suggestions sur la manière de contourner le problème, ou des informations sur une version où le problème est corrigé.
  • 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.

Installation de l’interface de ligne de commande Azure

Les RPM sont publiés pour Azure Linux via CBL-Mariner. Le package azure-cli prend en charge l’architecture ARM64 à partir de la version CLI 2.46.0.

Pour installer l’interface de ligne de commande Azure, procédez comme suit :

  1. Installez l’ensemble officiel de certificats racines approuvés organisés par Microsoft :

    sudo tdnf install ca-certificates

  2. Installez Azure CLI :

    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

Mettre à jour Azure CLI

Mettez à jour Azure CLI avec la commande tdnf update :

sudo tdnf update azure-cli

Désinstaller Azure CLI

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

Supprimer les données

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

rm -rf ~/.azure

Avant de commencer

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 :

Installez ou mettez à jour Azure CLI

L’installation comme la mise à jour d’Azure CLI impliquent de réexécuter le script d’installation.

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 les modifications soient prises en compte.

Désinstaller Azure CLI

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 le répertoire de base ($HOME) de l’utilisateur.

  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

Résolution des problèmes

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.

Installer sans Python 3

Azure CLI a retiré la prise en charge de Python 2.7 depuis la version 2.1.0. Sur votre système, il doit s’agir d’une version Python antérieure à l’exigence de Python 3.6.x. Recherchez un package de remplacement python3 .

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 parvenez pas à exécuter la commande après l’installation à l’aide de bash ou de zsh, essayez d’effacer le cache de hachage de commandes de votre interpréteur de commandes et vérifiez si le problème est résolu.

hash -r

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.

Les valeurs de ces variables sont utilisées par de nombreux programmes Linux et pendant 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. Il y a souvent des suggestions sur la manière de contourner le problème, ou des informations sur une version où le problème est corrigé.
  • 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.

É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