Installer Azure CLI sur macOS

L’interface de ligne de commande Azure (Azure CLI) permet d’exécuter des commandes par le biais d’un terminal en utilisant des invites de ligne de commande interactives ou un script. Vous pouvez installer Azure CLI localement sur des ordinateurs macOS. Azure CLI sur macOS 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.

Pour la plateforme macOS, vous pouvez installer Azure CLI avec le Gestionnaire de package Homebrew. Homebrew facilite le maintien à jour de votre installation de la mise à jour de l’interface CLI. Le package CLI a été testé sur macOS 10.9 et les versions ultérieures.

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

Installer avec Homebrew

Homebrew est le moyen le plus simple pour gérer votre installation d’interface de ligne de commande. Il offre des moyens pratiques pour installer, mettre à jour et désinstaller. Si vous ne disposez pas de Homebrew sur votre système, installez Homebrew avant de continuer.

Vous pouvez installer Azure CLI sur macOS en mettant à jour vos informations de référentiel Homebrew, puis en exécutant la commande install :

brew update && brew install azure-cli

Important

Azure CLI a une dépendance vis-à-vis du package Homebrew python3 et l’installe. Azure CLI offre la garantie d’être compatible avec la dernière version de python3 publiée sur Homebrew.

Dépannage

Si vous rencontrez un problème lors de l’installation de l’interface de ligne de commande via Homebrew, voici quelques erreurs courantes. Si vous rencontrez un problème n’étant pas évoqué ici, signalez un problème sur github.

La complétion ne fonctionne pas

La formule Homebrew d’Azure CLI installe un fichier de complétion nommé az dans le répertoire de complétion géré par Homebrew (l’emplacement par défaut est /usr/local/etc/bash_completion.d/). Pour permettre la complétion, suivez les instructions fournies par Homebrew.

Impossible de trouver des packages Python ou des packages installés

Une incompatibilité de version mineure ou un autre problème a pu se produire lors de l’installation de Homebrew. L’interface CLI n’utilise pas d’environnement virtuel Python, ainsi, elle s’appuie sur la recherche de la version de Python installée. Un correctif possible consiste à installer et à relier la dépendance python3 depuis Homebrew.

brew update && brew install python3 && brew upgrade python3
brew link --overwrite python3

La version 1.x de l’interface de ligne de commande est installée

Si une version obsolète a été installée, cela peut être dû à un cache Homebrew périmé. Suivez les instructions de mise à jour.

Le proxy bloque la connexion

Il se peut que vous ne puissiez pas obtenir des ressources à partir de Homebrew, sauf si vous l’avez correctement configuré pour utiliser votre proxy. Suivez les instructions d’installation de proxy Homebrew.

Important

Si vous vous trouvez derrière un proxy, HTTP_PROXY et HTTPS_PROXY doivent être définis 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 ressources Bottle de Homebrew, votre proxy doit autoriser les connexions HTTPS aux adresses suivantes :

  • https://formulae.brew.sh
  • https://homebrew.bintray.com

Update

L’interface de ligne de commande est régulièrement mise à jour avec des correctifs de bogues, des améliorations, de nouvelles fonctions ainsi que des fonctionnalités en préversion. Une nouvelle version est disponible à peu près toutes les trois semaines.

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 les informations de votre référentiel Homebrew local, puis mettre à niveau le package azure-cli.

brew update && brew upgrade 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.

Utilisez homebrew pour désinstaller le package azure-cli.

brew uninstall azure-cli

Supprimer les données

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

rm -rf ~/.azure

Autres méthodes d’installation

Si vous ne pouvez pas utiliser homebrew pour installer Azure CLI dans votre environnement, il est possible d’utiliser les instructions manuelles pour Linux. Notez que ce processus n’est pas officiellement conservé pour être compatible avec macOS. L’utilisation d’un gestionnaire de package tel que Homebrew est toujours recommandée. Utilisez uniquement la méthode d’installation manuelle si vous ne disposez d’aucune autre option disponible.

Pour les instructions d’installation manuelle, consultez Installer Azure CLI sur Linux manuellement.

Étapes suivantes

Maintenant que vous avez installé Azure CLI sur macOS, découvrez ses fonctionnalités et ses commandes courantes.