Installer Azure CLI sur macOS - Préversion

Azure CLI est un outil en ligne de commande multiplateforme permettant de gérer des ressources Azure de manière interactive ou via des scripts.

Sur macOS, Azure CLI passe de la formule Homebrew Core à un modèle d’installation plus facile à gérer et flexible. Le nouveau modèle inclut :

  • Homebrew Cask (recommandé pour la plupart des utilisateurs)
  • Tarball (recommandé pour les environnements hors connexion ou isolés physiquement)

Cette expérience est actuellement en préversion et deviendra l’approche d’installation standard dans une prochaine version.

Pourquoi utiliser Homebrew Cask ?

  • Expérience d’installation et de mise à niveau la plus simple
  • Gère automatiquement les dépendances
  • S’aligne sur le futur modèle d’installation pris en charge

Ce qui change

Azure CLI évolue pour prendre en charge l’authentification plus sécurisée, notamment l’authentification basée sur le répartiteur. Ces fonctionnalités nécessitent un modèle d’installation basé sur des conteneurs. Par conséquent, nous allons passer de Homebrew Core à Homebrew Cask. Cette modification ne supprime ni ne limite aucune fonctionnalité Azure CLI existante. Homebrew Cask est entièrement compatible avec toutes les fonctionnalités et versions actuelles de Azure CLI.

Cette modification améliore la cohérence entre les environnements et offre une meilleure prise en charge des scénarios tels que l’installation hors connexion et les environnements de déploiement contrôlés.

Important

Azure CLI est actuellement en préversion pour le modèle d’installation homebrew Cask. Pendant cette phase, l’installation est disponible uniquement via un tap personnalisé Homebrew.

  • Méthode actuelle : brew install azure-cli
  • Nouvelles méthodes (phase d’aperçu) :
    • Homebrew Cask via un dépôt personnalisé
      1. brew tap azure/azure-cli
      2. brew install --cask azure-cli-preview
    • Installation basée sur un fichier Tarball

Choisir une méthode d’installation

Utilisez les conseils suivants pour sélectionner la méthode d’installation qui convient le mieux à votre scénario :

Scénario Méthode recommandée
La plupart des utilisateurs Homebrew Cask (gestionnaire de paquets pour macOS)
Systèmes hors connexion ou à isolation physique Archive tar
Emplacement d’installation personnalisé requis Archive tar

Installer Azure CLI à l’aide de Homebrew Cask

Homebrew offre l’expérience d’installation la plus simple et la plus facile à gérer pour Azure CLI sur macOS. Il gère l’installation, les mises à niveau et la suppression à l’aide de workflows de gestion de package standard.

Prerequisites

  • macOS (Apple Silicon ou Intel)
  • Homebrew installé

Si Azure CLI est déjà installé à l’aide de la formule Homebrew, désinstallez-la avant de continuer pour éviter les conflits :

brew uninstall azure-cli

Installer Azure CLI

Cette opération installe Azure CLI en utilisant le cask Homebrew à partir du tap personnalisé Azure CLI. Il s’agit de la seule méthode d’installation de Homebrew prise en charge pendant la phase d’évaluation.

brew tap azure/azure-cli
brew install --cask azure-cli-preview

Vérifier l’installation

Après l’installation, vérifiez que Azure CLI est disponible :

az --version

Mettre à niveau Azure CLI

Pour effectuer une mise à niveau vers la dernière version :

brew update && brew upgrade --cask azure-cli-preview

Désinstaller Azure CLI

Pour supprimer Azure CLI :

brew uninstall --cask azure-cli-preview
brew untap azure/azure-cli

Après la phase d’aperçu

Lorsque l’installation de Homebrew Cask devient généralement disponible :

  • La méthode d’installation d'aperçu (azure-cli-preview via un tap personnalisé) sera supprimée.
  • Azure CLI sera disponible à partir du dépôt officiel Homebrew Cask.

Installez Azure CLI à l’aide de :

brew install --cask azure-cli
# Or
brew install azure-cli

Les installations existantes utilisant la formule Homebrew Core doivent migrer vers l’installation basée sur Cask. La formule Homebrew Core ne sera plus prise en charge après cette transition.

Installer Azure CLI à l’aide d’un Tarball

Utilisez cette méthode si :

  • Homebrew n’est pas disponible
  • L’accès à Internet est restreint
  • Vous avez besoin d’un contrôle total sur l’emplacement d’installation

Cette méthode est couramment utilisée dans les environnements d’entreprise, réglementés ou isolés.

Prerequisites

  • macOS (Apple Silicon ou Intel)
  • Python 3.13 installé via n’importe quelle méthode (python.org, pyenv, etc.)

Télécharger le tarball

Sur un ordinateur disposant d’un accès Internet, vous pouvez télécharger automatiquement la dernière Azure CLI tarball pour votre architecture :

ARCH=$(uname -m)
VER=$(curl -s https://api.github.com/repos/Azure/azure-cli/releases/latest | grep tag_name | cut -d '"' -f4 | sed 's/azure-cli-//')
curl -L -o az.tar.gz "https://github.com/Azure/azure-cli/releases/download/azure-cli-$VER/azure-cli-$VER-macos-$ARCH.tar.gz"

Ce script détecte votre architecture et télécharge la dernière archive tarball Azure CLI depuis la page des versions de l’Azure CLI.

  • arm64 indique Apple Silicon
  • x86_64 indique Intel

La sélection de l’architecture appropriée garantit la compatibilité et les performances optimales.

Conseil / Astuce

Pour les environnements hors connexion, exécutez cette commande sur un ordinateur disposant d’un accès Internet, puis transférez le tarball téléchargé vers le système cible.

Extraire dans le répertoire d’installation

Choisissez un répertoire dans lequel Azure CLI devez être installé :

mkdir -p $HOME/lib/azure-cli
tar -xzf az.tar.gz -C $HOME/lib/azure-cli

Configurer des variables d’environnement

Azure CLI nécessite l’accès à un runtime de Python. Configurez votre environnement pour qu’il pointe vers Python et les fichiers binaires Azure CLI.

Ajoutez ce qui suit à votre profil shell (~/.zshrc ou ~/.bashrc) :

export AZ_PYTHON="/path_to_python"
export PATH="/target_directory_path/bin:$PATH"

Rechargez la configuration de votre interpréteur de commandes :

source ~/.zshrc

Vérifier l’installation

az --version

Mettre à niveau Azure CLI

Pour mettre à niveau Azure CLI dans un environnement hors connexion, téléchargez un tarball plus récent et extrayez-le sur l’installation existante :

sudo tar -xzf az.tar.gz -C /target_directory_path

Désinstaller Azure CLI

Supprimez le répertoire d’installation :

sudo rm -rf /target_directory_path

Ensuite, supprimez les entrées AZ_PYTHON et PATH de votre profil d’interpréteur de commandes.

Résolution des problèmes

Si vous rencontrez un problème lors de l’installation ou de l’utilisation de l’Azure CLI avec Homebrew Cask ou la méthode Tarball, voici quelques erreurs courantes (dont beaucoup sont spécifiques à Homebrew). Si vous rencontrez un problème qui n’est pas traité ici, signalez ce problème sur GitHub.

Azure CLI introuvable

Vérifiez que votre chemin d’accès inclut le répertoire d’installation :

echo $PATH

La saisie semi-automatique ne fonctionne pas

L'installation Azure CLI Homebrew (via la formule ou le cask) fournit un fichier de complétion nommé az dans le répertoire des complétions gérés par Homebrew. Pour activer l’achèvement, suivez les instructions de Homebrew.

Pour Zsh, ajoutez les deux lignes suivantes au bas de votre fichier .zshrc, puis enregistrez et rechargez votre profil Zsh.

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

Impossible de trouver Python ni les packages installés

Il peut y avoir une incompatibilité de version mineure ou un autre problème lors de l’installation de homebrew. Azure CLI n'utilise pas d'environnement virtuel Python, il s'appuie donc sur la recherche de la version Python installée. Un correctif possible consiste à installer et à relier la dépendance python@3.13 depuis Homebrew.

brew update && brew install python@3.13 && brew upgrade python@3.13
brew link --overwrite python@3.13

Le proxy bloque la connexion

Vous ne pouvez peut-être pas obtenir des ressources à partir de Homebrew, sauf si vous le configurez pour utiliser votre proxy. Suivez les instructions d’installation de proxy Homebrew.

Important

Si vous êtes derrière un proxy, HTTP_PROXY et HTTPS_PROXY doivent être configurés pour permettre la connexion aux services Azure avec Azure CLI. Si vous n’utilisez pas l’authentification de base, vous devez exporter ces variables dans votre .bashrc fichier. Suivez toujours les stratégies de sécurité de votre entreprise et les exigences de votre administrateur système.

Pour obtenir les ressources de bouteille à partir de Homebrew, votre proxy doit autoriser les connexions HTTPS aux adresses suivantes :

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

Prochaines étapes

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

Commencez avec l'Azure CLI

  • Last updated on