Instalowanie Azure CLI w systemie macOS — wersja zapoznawcza

Azure CLI to międzyplatformowe narzędzie wiersza polecenia do zarządzania zasobami Azure interaktywnie lub za pośrednictwem skryptów.

W systemie macOS Azure CLI przechodzi od formuły Homebrew Core do bardziej konserwowalnego i elastycznego modelu instalacji. Nowy model obejmuje:

• Homebrew Cask (zalecane dla większości użytkowników)
• Tarball (zalecane w przypadku środowisk w trybie offline lub w środowiskach odizolowanych od sieci)

To środowisko jest obecnie w wersji zapoznawczej i stanie się standardowym podejściem instalacyjnym w przyszłej wersji.

Dlaczego warto używać oprogramowania Homebrew Cask?

• Najprostsze środowisko instalacji i uaktualniania
• Automatycznie zarządza zależnościami
• Jest kompatybilny z przyszłym obsługiwanym modelem instalacji

Co się zmienia

Azure CLI rozwija się w celu obsługi bezpieczniejszego uwierzytelniania, w tym uwierzytelniania opartego na brokerze. Te możliwości wymagają modelu instalacji opartego na pakietach cask. W rezultacie przechodzimy z Homebrew Core do Homebrew Cask. Ta zmiana nie usuwa ani nie ogranicza żadnych istniejących funkcji Azure CLI. Oprogramowanie Homebrew Cask jest w pełni zgodne ze wszystkimi bieżącymi funkcjami i wersjami Azure CLI.

Ta zmiana zwiększa spójność w środowiskach i zapewnia lepszą obsługę scenariuszy, takich jak instalacja w trybie offline i kontrolowane środowiska wdrażania.

Ważna

Azure CLI jest obecnie w fazie zapoznawczej dla modelu instalacji oprogramowania Homebrew Cask. W tej fazie instalacja jest dostępna tylko za pośrednictwem niestandardowego naciśnięcia oprogramowania Homebrew.

• Bieżąca metoda: brew install azure-cli
• Nowe metody (faza podglądu):
  • Homebrew Cask za pomocą naciśnięcia niestandardowego
    1. brew tap azure/azure-cli
    2. brew install --cask azure-cli-preview
  • Instalacja oparta na tarballu

Wybieranie metody instalacji

Skorzystaj z poniższych wskazówek, aby wybrać metodę instalacji, która najlepiej pasuje do danego scenariusza:

Scenario	Zalecana metoda
Większość użytkowników	Homebrew Cask
Systemy offline lub odizolowane	Archiwum
Wymagana niestandardowa lokalizacja instalacji	Archiwum

Instalowanie Azure CLI przy użyciu oprogramowania Homebrew Cask

Oprogramowanie Homebrew zapewnia najprostsze i najbardziej konserwowalne środowisko instalacji dla Azure CLI w systemie macOS. Obsługuje instalację, uaktualnienia i usuwanie przy użyciu standardowych przepływów pracy zarządzania pakietami.

Wymagania wstępne

• macOS (Apple Silicon lub Intel)
• Zainstalowane oprogramowanie Homebrew

Jeśli Azure CLI jest już zainstalowana przy użyciu formuły Homebrew, odinstaluj ją przed kontynuowaniem, aby uniknąć konfliktów:

brew uninstall azure-cli

Instalowanie Azure CLI

Spowoduje to zainstalowanie Azure CLI przy użyciu narzędzia Homebrew Cask z poziomu Azure CLI naciśnięcia niestandardowego. Jest to jedyna obsługiwana metoda instalacji oprogramowania Homebrew w fazie zapoznawczej.

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

Weryfikowanie instalacji

Po zakończeniu instalacji upewnij się, że Azure CLI jest dostępna:

az --version

Uaktualnianie Azure CLI

Aby uaktualnić do najnowszej wersji:

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

Odinstalowywanie Azure CLI

Aby usunąć Azure CLI:

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

Po fazie przeglądu

Gdy instalacja oprogramowania Homebrew Cask stanie się ogólnie dostępna:

• Metoda instalacji w wersji zapoznawczej (azure-cli-preview za pomocą naciśnięcia niestandardowego) zostanie przerwana.
• Azure CLI będą dostępne z oficjalnego repozytorium Homebrew Cask.

Zainstaluj Azure CLI przy użyciu:

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

Istniejące instalacje korzystające z formuły Homebrew Core muszą zostać zmigrowane do instalacji opartej na systemie Cask. Formuła Homebrew Core nie będzie już obsługiwana po tym przejściu.

Instalowanie Azure CLI przy użyciu narzędzia Tarball

Użyj tej metody, jeśli:

• Oprogramowanie Homebrew nie jest dostępne
• Dostęp do Internetu jest ograniczony
• Potrzebna jest pełna kontrola nad lokalizacją instalacji

Ta metoda jest często używana w środowiskach korporacyjnych, regulowanych lub odciętych od sieci.

Wymagania wstępne

• macOS (Apple Silicon lub Intel)
• Python 3.13 zainstalowany za pomocą dowolnej metody (python.org, pyenv itp.)

Pobierz tarball

Na maszynie z dostępem do Internetu możesz automatycznie pobrać najnowszy tarball Azure CLI dla używanej architektury.

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"

Ten skrypt wykrywa architekturę i pobiera najnowszy tarball Azure CLI ze strony z nowymi wersjami Azure CLI.

• arm64 wskazuje Apple Silicon
• x86_64 oznacza Intel

Wybranie prawidłowej architektury zapewnia zgodność i optymalną wydajność.

Wskazówka

W przypadku środowisk offline uruchom to polecenie na maszynie z dostępem do Internetu, a następnie przenieś pobrany tarball do systemu docelowego.

Wyodrębnianie do katalogu instalacyjnego

Wybierz katalog, w którym należy zainstalować Azure CLI:

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

Konfigurowanie zmiennych środowiskowych

Azure CLI wymaga dostępu do środowiska uruchomieniowego Python. Skonfiguruj środowisko tak, aby wskazywało Python i pliki binarne Azure CLI.

Dodaj następujący kod do profilu shella (~/.zshrc lub ~/.bashrc):

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

Załaduj ponownie konfigurację powłoki:

source ~/.zshrc

Weryfikowanie instalacji

az --version

Uaktualnianie Azure CLI

Aby uaktualnić Azure CLI w środowisku offline, pobierz nowszą aplikację Tarball i wyodrębnij ją z istniejącej instalacji:

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

Odinstalowywanie Azure CLI

Usuń katalog instalacyjny:

sudo rm -rf /target_directory_path

Następnie usuń wpisy AZ_PYTHON i PATH z profilu powłoki.

Troubleshooting

Jeśli wystąpi problem podczas instalowania lub używania Azure CLI z metodą Homebrew Cask lub Tarball, poniżej przedstawiono niektóre typowe błędy (z których wiele jest specyficznych dla oprogramowania Homebrew). Jeśli napotkasz problem, który nie został tutaj omówiony, zgłoś problem na GitHubie.

nie znaleziono Azure CLI

Upewnij się, że ścieżka zawiera katalog instalacyjny:

echo $PATH

Autouzupełnianie nie działa

Instalacja Azure CLI za pośrednictwem Homebrew (niezależnie od tego, czy poprzez formułę, czy pakiet cask) udostępnia plik autouzupełniania o nazwie az w katalogu zarządzanych dopełnień Homebrew. Aby włączyć uzupełnianie, postępuj zgodnie z instrukcjami oprogramowania Homebrew.

W środowisku Zsh dodaj następujące dwa wiersze na końcu pliku .zshrc, a następnie zapisz i ponownie wczytaj swój profil Zsh.

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

Nie można odnaleźć języka Python lub zainstalowanych pakietów

Podczas instalacji homebrew może wystąpić niezgodność wersji mniejszej lub inny problem. Azure CLI nie używa Python środowiska wirtualnego, dlatego polega na znalezieniu zainstalowanej wersji Python. Możliwe rozwiązanie polega na zainstalowaniu i ponownym połączeniu zależności python@3.13 z oprogramowania Homebrew.

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

Serwer proxy blokuje połączenie

Być może nie możesz pobrać zasobów z oprogramowania Homebrew, chyba że skonfigurujesz go do korzystania z serwera proxy. Postępuj zgodnie z instrukcjami konfiguracji serwera proxy oprogramowania Homebrew.

Ważna

Jeśli jesteś za serwerem proxy, musisz ustawić HTTP_PROXY i HTTPS_PROXY, aby nawiązać połączenie z usługami Azure za pomocą Azure CLI. Jeśli nie używasz podstawowego uwierzytelniania, należy wyeksportować te zmienne w .bashrc pliku. Zawsze przestrzegaj zasad zabezpieczeń firmy i wymagań administratora systemu.

Aby uzyskać zasoby butelki z oprogramowania Homebrew, serwer proxy musi zezwolić na połączenia HTTPS z następującymi adresami:

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

Dalsze kroki

Po zainstalowaniu Azure CLI w systemie macOS zapoznaj się z jej funkcjami i typowymi poleceniami.

Rozpocznij pracę z Azure CLI