Azure CLI installeren in macOS - Preview

Azure CLI is een platformoverschrijdend opdrachtregelprogramma voor het interactief of via scripts beheren van Azure resources.

In macOS gaat Azure CLI weg van de Homebrew Core-formule naar een beter onderhoudbaar en flexibel installatiemodel. Het nieuwe model bevat:

  • Homebrew Cask (aanbevolen voor de meeste gebruikers)
  • Tarball (aanbevolen voor offline en afgeschermde omgevingen)

Deze ervaring is momenteel in preview en wordt de standaardinstallatiemethode in een toekomstige versie.

Waarom Homebrew Cask gebruiken?

  • Eenvoudigste installatie- en upgrade-ervaring
  • Automatisch afhankelijkheden beheren
  • Wordt uitgelijnd met het toekomstige ondersteunde installatiemodel

Wat verandert er?

Azure CLI zich ontwikkelt om veiligere verificatie te ondersteunen, waaronder verificatie op basis van broker. Voor deze functies is een cask-gebaseerd installatiemodel vereist. Als gevolg hiervan gaan we overstappen van Homebrew Core naar Homebrew Cask. Met deze wijziging worden bestaande Azure CLI functionaliteit niet verwijderd of beperkt. Homebrew Cask is volledig compatibel met alle huidige Azure CLI functies en versies.

Deze wijziging verbetert de consistentie tussen omgevingen en biedt betere ondersteuning voor scenario's zoals offline-installatie en gecontroleerde implementatieomgevingen.

Important

Azure CLI bevindt zich momenteel in een preview-fase voor het Homebrew Cask-installatiemodel. Tijdens deze fase is de installatie alleen beschikbaar via een aangepaste Homebrew-tik.

  • Huidige methode: brew install azure-cli
  • Nieuwe methoden (preview-fase):
    • Homebrew Cask via aangepaste tik
      1. brew tap azure/azure-cli
      2. brew install --cask azure-cli-preview
    • Installatie op basis van Tarball

Een installatiemethode kiezen

Gebruik de volgende richtlijnen om de installatiemethode te selecteren die het beste bij uw scenario past:

Scenario Aanbevolen methode
De meeste gebruikers Homebrew Cask
Offline- of lucht-gapped systemen Tarball
Aangepaste installatielocatie vereist Tarball

Azure CLI installeren met Homebrew Cask

Homebrew biedt de eenvoudigste en meest onderhoudbare installatie-ervaring voor Azure CLI op macOS. Het verwerkt installatie, upgrades en verwijdering met behulp van standaardwerkstromen voor pakketbeheer.

Prerequisites

  • macOS (Apple Silicon of Intel)
  • Homebrew geïnstalleerd

Als Azure CLI al is geïnstalleerd met de Homebrew-formule, verwijdert u deze voordat u doorgaat om conflicten te voorkomen:

brew uninstall azure-cli

Azure-CLI installeren

Hiermee wordt Azure CLI geïnstalleerd met behulp van Homebrew Cask vanuit de Azure CLI aangepaste tap. Dit is de enige ondersteunde Homebrew-installatiemethode tijdens de preview-fase.

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

Installatie controleren

Controleer na de installatie of Azure CLI beschikbaar is:

az --version

Azure CLI bijwerken

Ga als volgende te werk om een upgrade uit te voeren naar de nieuwste versie:

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

Azure CLI verwijderen

Azure CLI verwijderen:

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

Na de preview-fase

Wanneer de Homebrew Cask-installatie algemeen beschikbaar wordt:

  • De preview-installatiemethode (azure-cli-preview via aangepaste tap) wordt stopgezet.
  • Azure CLI is beschikbaar in de officiële Homebrew Cask-opslagplaats.

Installeer Azure CLI met behulp van:

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

Bestaande installaties met de Homebrew Core-formule moeten worden gemigreerd naar de installatie op basis van Cask. De Homebrew Core-formule wordt na deze overgang niet meer ondersteund.

Azure CLI installeren met een Tarball

Gebruik deze methode als:

  • Homebrew is niet beschikbaar
  • Internettoegang is beperkt
  • U hebt volledige controle over de installatielocatie nodig

Deze methode wordt vaak gebruikt in bedrijfsomgevingen, gereguleerde omgevingen of air-gapped omgevingen.

Prerequisites

  • macOS (Apple Silicon of Intel)
  • Python 3.13 geïnstalleerd via elke methode (python.org, pyenv, enzovoort)

De tarball downloaden

Op een computer met internettoegang kunt u automatisch de nieuwste Azure CLI tarball voor uw architectuur downloaden:

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"

Dit script detecteert uw architectuur en downloadt de meest recente Azure CLI tarball vanaf de Azure CLI releasepagina.

  • arm64 geeft Apple Silicon aan
  • x86_64 geeft Intel aan

Het selecteren van de juiste architectuur zorgt voor compatibiliteit en optimale prestaties.

Tip

Voor offlineomgevingen voert u deze opdracht uit op een computer met internettoegang en brengt u vervolgens de gedownloade tarball over naar het doelsysteem.

Uitpakken naar installatiemap

Kies een map waarin Azure CLI moet worden geïnstalleerd:

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

Omgevingsvariabelen configureren

Azure CLI vereist toegang tot een Python runtime. Configureer uw omgeving zodat deze verwijst naar Python en de binaire Azure CLI bestanden.

Voeg het volgende toe aan uw shell-profiel (~/.zshrc of ~/.bashrc):

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

Laad de shellconfiguratie opnieuw:

source ~/.zshrc

Installatie controleren

az --version

Azure CLI bijwerken

Als u Azure CLI wilt upgraden in een offlineomgeving, downloadt u een nieuwere Tarball en extraheert u deze over de bestaande installatie:

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

Azure CLI verwijderen

Verwijder de installatiemap:

sudo rm -rf /target_directory_path

Verwijder vervolgens de AZ_PYTHON en PATH vermeldingen uit uw shell-profiel.

Troubleshooting

Als u een probleem ondervindt bij het installeren of gebruiken van de Azure CLI met Homebrew Cask of de Tarball-methode, zijn hier enkele veelvoorkomende fouten (waarvan veel specifiek zijn voor Homebrew). Als u een probleem ondervindt dat hier niet wordt behandeld, kunt u een probleem indienen op GitHub.

Azure CLI niet gevonden

Zorg ervoor dat uw PATH de installatiemap bevat:

echo $PATH

Voltooiing werkt niet

De Azure CLI Homebrew-installatie (via formule of cask) biedt een voltooiingsbestand met de naam az in de map met beheerde voltooiingen van Homebrew. Volg de instructies van Homebrew om voltooiing in te schakelen.

Voeg voor Zsh de volgende twee regels toe aan de onderkant van het .zshrc bestand en sla uw Zsh-profiel op en laad het opnieuw.

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

Kan Python of geïnstalleerde pakketten niet vinden

Er kan een kleine versie conflict of een ander probleem optreden tijdens het installeren van homebrew. Azure CLI geen Python virtuele omgeving gebruikt, dus is het afhankelijk van het vinden van de geïnstalleerde Python versie. Een mogelijke oplossing is het installeren en opnieuw koppelen van de python@3.13-afhankelijkheid van Homebrew.

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

Proxy blokkeert verbinding

Mogelijk kunt u geen resources ophalen uit Homebrew, tenzij u deze configureert voor het gebruik van uw proxy. Volg de configuratie-instructies voor de Homebrew-proxy.

Important

Als u zich achter een proxy bevindt, moeten HTTP_PROXY en HTTPS_PROXY worden ingesteld om verbinding te maken met Azure-services via de Azure CLI. Als u geen basisverificatie gebruikt, moet u deze variabelen exporteren in uw .bashrc bestand. Volg altijd het beveiligingsbeleid van uw bedrijf en de vereisten van uw systeembeheerder.

Als u de flesbronnen van Homebrew wilt ophalen, moet uw proxy HTTPS-verbindingen met de volgende adressen toestaan:

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

Volgende stappen

Nu u de Azure CLI in macOS hebt geïnstalleerd, kunt u de functies en algemene opdrachten kort bekijken.

Aan de slag gaan met de Azure CLI

  • Last updated on