Delen via


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 zorgt u er eenvoudig voor dat de CLI-installatie altijd wordt bijgewerkt. Het CLI-pakket is getest voor macOS-versies 10.9 en hoger.

De huidige versie van de Azure CLI is 2.66.0. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release. Als u de geïnstalleerde versie wilt zoeken en wilt zien of u wilt bijwerken, voert u az version uit.

De installatie uitvoeren met Homebrew

Homebrew is de eenvoudigste manier om de 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

Probleemoplossing

Als u een probleem ondervindt tijdens het installeren van de CLI met Homebrew, kunt u de volgende veelvoorkomende fouten bekijken. 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 sprake zijn van versies die niet helemaal overeenkomen of van andere problemen tijdens de installatie van Homebrew. Omdat de CLI geen virtuele Python-omgeving gebruikt, wordt ervan uitgegaan dat de geïnstalleerde versie van Python wordt gevonden. 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

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 van Homebrew, tenzij u deze juist hebt geconfigureerd voor het gebruik van uw proxy. Volg de configuratie-instructies voor de Homebrew-proxy.

Belangrijk

Als u zich achter een proxy HTTP_PROXY bevindt en HTTPS_PROXY moet zijn ingesteld om verbinding te maken met Azure-services met de CLI. Als u geen basisverificatie gebruikt, is het raadzaam om deze variabelen in uw .bashrc bestand te exporteren. 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

Bijwerken

De CLI wordt regelmatig bijgewerkt met oplossingen voor problemen, verbeteringen, nieuwe functies en preview-functies. Er is ongeveer om de drie weken 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 referentiepagina voor opdrachten voor meer az upgrade 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

Verwijderen

We zouden het jammer vinden als u besluit om Azure CLI te verwijderen. Voordat u de CLI verwijdert, gebruikt u de az feedback-opdracht 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 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 gebruik van een pakketbeheerder zoals Homebrew wordt altijd aanbevolen. 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, volgt u een korte rondleiding door de functies en algemene opdrachten.