Azure CLI installeren in macOS

De Azure-opdrachtregelinterface (CLI) is een platformoverschrijdend opdrachtregelprogramma dat lokaal kan worden geïnstalleerd op macOS-computers. U kunt de Azure CLI gebruiken om verbinding te maken met Azure en beheeropdrachten uit te voeren op Azure-resources met behulp van interactieve opdrachtregelprompts of een script.

Installeer de Azure CLI met homebrew-pakketbeheer voor het macOS-platform. Met Homebrew kunt u eenvoudig uw installatie van de Azure CLI up-to-date houden. Voor het Azure CLI-pakket is macOS 13 of hoger vereist.

De huidige versie van de Azure CLI is 2.78.0. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release. Om uw geïnstalleerde versie te vinden en te zien of u moet bijwerken, voert u az version uit.

Installeren met Homebrew

Homebrew is de eenvoudigste manier om uw Azure CLI-installatie te beheren. Het biedt handige manieren om te installeren, bij te werken en te verwijderen. Als uw systeem niet beschikt over Homebrew, installeert u Homebrew voordat u doorgaat.

U kunt de Azure CLI installeren in macOS door de informatie over de brew-opslagplaats bij te werken en vervolgens de opdracht uit te install voeren:

brew update && brew install azure-cli

Probleemoplossingsproces

Als u een probleem ondervindt bij het installeren van de Azure CLI via Homebrew, vindt u hier enkele veelvoorkomende fouten. Als u een probleem ondervindt dat hier niet wordt behandeld, kunt u een probleem indienen op GitHub.

Voltooiing werkt niet

De Homebrew-formule van Azure CLI installeert een voltooiingsbestand met de naam az in de map met door Homebrew beheerde voltooiingen (standaardlocatie is /usr/local/etc/bash_completion.d/). Volg hier 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. De Azure CLI maakt geen gebruik van een virtuele Python-omgeving, dus is afhankelijk van het vinden van de geïnstalleerde Python-versie. Een mogelijke oplossing is het installeren en opnieuw koppelen van de python@3.10-afhankelijkheid van Homebrew.

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

Azure CLI versie 1.x is geïnstalleerd

Als er een verouderde versie is geïnstalleerd, komt dit mogelijk door een verouderde Homebrew-cache. Volg de instructies onder Bijwerken.

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.

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

bijwerken

De Azure CLI wordt regelmatig bijgewerkt met bugfixes, verbeteringen, nieuwe functies en preview-functionaliteit. Er is ongeveer één keer per maand een nieuwe release beschikbaar.

Vanaf versie 2.11.0 biedt de Azure CLI een opdracht in het hulpprogramma om bij te werken naar de nieuwste versie.

az upgrade

Met deze opdracht worden ook alle geïnstalleerde extensies standaard bijgewerkt. Zie de az upgrade voor meer opties. Update voor Azure CLI-versies vóór 2.11.0 door opnieuw te installeren, zoals beschreven in De Azure CLI installeren.

U kunt ook de gegevens van uw lokale Homebrew-opslagplaats bijwerken en vervolgens het azure-cli pakket upgraden.

brew update && brew upgrade azure-cli

Deïnstalleren

Als u besluit om de Azure CLI te verwijderen, vinden we het jammer dat u weggaat. Voordat u de installatie ongedaan gaat maken, gebruikt u de opdracht az feedback om ons te laten weten wat er kan worden verbeterd of opgelost. Ons doel is om Azure CLI zo gebruiksvriendelijk mogelijk te maken en vrij te houden van bugs. Als u een bug vindt, zouden we het waarderen als u dat meldt op GitHub.

Verwijder het azure-cli-pakket met Homebrew.

brew uninstall azure-cli

Gegevens verwijderen

Als u de Azure CLI niet opnieuw wilt installeren, verwijdert u de bijbehorende gegevens.

rm -rf ~/.azure

Andere installatiemethoden

Als u homebrew niet kunt gebruiken om de Azure CLI in uw omgeving te installeren, kunt u de handmatige instructies voor Linux gebruiken. Dit proces wordt niet officieel onderhouden om compatibel te zijn met macOS. Het wordt aanbevolen om een pakketbeheerder zoals Homebrew te gebruiken. Gebruik alleen de handmatige installatiemethode als u geen andere optie beschikbaar hebt.

Zie Azure CLI handmatig installeren in Linux voor de instructies voor handmatige installatie.

Volgende stappen

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