Installera Azure CLI på macOS – förhandsversion

Azure CLI är ett plattformsoberoende kommandoradsverktyg för att hantera Azure resurser interaktivt eller via skript.

I macOS övergår Azure CLI från Homebrew Core-formeln till en mer underhållsbar och flexibel installationsmodell. Den nya modellen innehåller:

  • Homebrew Cask (rekommenderas för de flesta användare)
  • Tarball (rekommenderas för offline- eller luftgapade miljöer)

Den här upplevelsen är för närvarande i förhandsversion och kommer att bli standardinstallationsmetod i en framtida version.

Varför ska jag använda Homebrew Cask?

  • Enklaste installations- och uppgraderingsupplevelse
  • Hanterar beroenden automatiskt
  • Överensstämmer med installationsmodellen som stöds i framtiden

Vad förändras?

Azure CLI utvecklas för att stödja säkrare autentisering, inklusive asynkron autentisering. Dessa funktioner kräver en cask-baserad installationsmodell. Därför övergår vi från Homebrew Core till Homebrew Cask. Den här ändringen tar inte bort eller begränsar inte befintliga Azure CLI funktioner. Homebrew Cask är helt kompatibelt med alla aktuella Azure CLI funktioner och versioner.

Den här ändringen förbättrar konsekvensen mellan miljöer och ger bättre stöd för scenarier som offlineinstallation och kontrollerade distributionsmiljöer.

Important

Azure CLI är för närvarande i en förhandsversionsfas för Homebrew Cask-installationsmodellen. Under den här fasen är installationen endast tillgänglig via en anpassad Homebrew-tryckning.

  • Aktuell metod: brew install azure-cli
  • Nya metoder (förhandsversionsfas):
    • Homebrew Cask via anpassad tap
      1. brew tap azure/azure-cli
      2. brew install --cask azure-cli-preview
    • Tarball-baserad installation

Välj en installationsmetod

Använd följande vägledning för att välja den installationsmetod som passar bäst för ditt scenario:

Scenario Rekommenderad metod
De flesta användare Homebrew Cask
Offline- eller luftgapade system Tarball
Anpassad installationsplats krävs Tarball

Installera Azure CLI med Homebrew Cask

Homebrew ger den enklaste och mest underhållsbara installationsupplevelsen för Azure CLI på macOS. Den hanterar installation, uppgraderingar och borttagning med hjälp av standardarbetsflöden för pakethantering.

Förutsättningar

  • macOS (Apple Silicon eller Intel)
  • Homebrew installerat

Om Azure CLI redan har installerats med hjälp av Homebrew-formeln avinstallerar du den innan du fortsätter för att undvika konflikter:

brew uninstall azure-cli

Installera Azure CLI

Detta installerar Azure CLI med hjälp av Homebrew Cask från ett anpassat Azure CLI-tap. Det här är den enda homebrew-installationsmetoden som stöds under förhandsversionsfasen.

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

Verifiera installationen

Efter installationen kontrollerar du att Azure CLI är tillgänglig:

az --version

Uppgradera Azure CLI

Så här uppgraderar du till den senaste versionen:

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

Avinstallera Azure CLI

Ta bort Azure CLI:

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

Efter förhandsgranskningsfasen

När Installationen av Homebrew Cask blir allmänt tillgänglig:

  • Installationsmetoden för förhandsversionen (azure-cli-preview via anpassad tryckning) kommer att upphöra.
  • Azure CLI kommer att finnas tillgänglig från den officiella Homebrew Cask-lagringsplatsen.

Installera Azure CLI med:

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

Befintliga installationer med hjälp av Homebrew Core-formeln måste migreras till den Cask-baserade installationen. Homebrew Core-formeln stöds inte längre efter den här övergången.

Installera Azure CLI med hjälp av en Tarball

Använd den här metoden om:

  • Homebrew är inte tillgängligt
  • Internetåtkomsten är begränsad
  • Du behöver fullständig kontroll över installationsplatsen

Den här metoden används ofta i företagsmiljöer, reglerade miljöer eller i luftgapade miljöer.

Förutsättningar

  • macOS (Apple Silicon eller Intel)
  • Python 3.13 installeras via valfri metod (python.org, pyenv osv.)

Ladda ned tarball

På en dator med internetåtkomst kan du automatiskt ladda ned den senaste Azure CLI tarball för din arkitektur:

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"

Det här skriptet identifierar din arkitektur och laddar ner det senaste Azure CLI-tar-arkivet från Azure CLI:s releasesida.

  • arm64 indikerar Apple Silicon
  • x86_64 anger Intel

Om du väljer rätt arkitektur säkerställs kompatibilitet och optimala prestanda.

Tip

För offlinemiljöer kör du det här kommandot på en dator med internetåtkomst och överför sedan den nedladdade tarballen till målsystemet.

Extrahera till installationskatalog

Välj en katalog där Azure CLI ska installeras:

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

Konfigurera miljövariabler

Azure CLI kräver åtkomst till en Python körning. Konfigurera din miljö så att den pekar på Python och Azure CLI binärfiler.

Lägg till följande i din shell-profil (~/.zshrc eller ~/.bashrc):

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

Ladda om shell-konfigurationen:

source ~/.zshrc

Verifiera installationen

az --version

Uppgradera Azure CLI

Om du vill uppgradera Azure CLI i en offlinemiljö laddar du ned en nyare Tarball och extraherar den över den befintliga installationen:

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

Avinstallera Azure CLI

Ta bort installationskatalogen:

sudo rm -rf /target_directory_path

Ta sedan bort posterna AZ_PYTHON och PATH från din shell-profil.

Troubleshooting

Om du stöter på ett problem när du installerar eller använder Azure CLI med antingen Homebrew Cask eller Tarball-metoden, här är några vanliga fel (varav många är specifika för Homebrew). Om du upplever ett problem som inte beskrivs här kan du skapa ett problem på GitHub.

Azure CLI hittades inte

Se till att PATH innehåller installationskatalogen:

echo $PATH

Slutförande fungerar inte

Installationen av Azure CLI via Homebrew (antingen via formel eller fat) innehåller en kompletteringsfil med namnet az i Homebrews katalog för hanterade kompletteringar. Om du vill aktivera slutförande följer du Homebrews instruktioner.

För Zsh lägger du till följande två rader längst ned i .zshrc filen och sparar och läser sedan in Zsh-profilen igen.

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

Det går inte att hitta Python eller installerade paket

Det kan finnas ett felmatchningsfel i delversionen eller något annat problem under homebrew-installationen. Azure CLI använder inte en Python virtuell miljö, så den förlitar sig på att hitta den installerade Python versionen. En möjlig lösning är att installera och länka om python@3.13-beroendet från Homebrew.

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

Proxy blockerar anslutning

Du kanske inte kan hämta resurser från Homebrew om du inte konfigurerar den så att den använder proxyn. Följ konfigurationsanvisningarna för Homebrew-proxyn.

Important

För att ansluta till Azure-tjänster med Azure CLI, om du använder en proxyserver, måste HTTP_PROXY och HTTPS_PROXY ställas in. Om du inte använder grundläggande autentisering bör du exportera dessa variabler i .bashrc filen. Följ alltid företagets säkerhetsprinciper och systemadministratörens krav.

För att hämta flaskresurserna från Homebrew måste proxyn tillåta HTTPS-anslutningar till följande adresser:

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

Nästa steg

Nu när du har installerat Azure CLI på macOS kan du ta en kort genomgång av dess funktioner och vanliga kommandon.

Kom igång med Azure CLI

  • Last updated on