Instalowanie interfejsu wiersza polecenia platformy Azure w systemie macOS

Interfejs azure Command-Line (CLI) to międzyplatformowe narzędzie wiersza polecenia, które można zainstalować lokalnie na komputerach z systemem macOS. Interfejs wiersza polecenia platformy Azure umożliwia nawiązywanie połączenia z platformą Azure i wykonywanie poleceń administracyjnych w zasobach platformy Azure przy użyciu interakcyjnych wierszy polecenia lub skryptu.

W przypadku platformy macOS zainstaluj Azure CLI za pomocą menedżera pakietów Homebrew. Oprogramowanie Homebrew ułatwia aktualizowanie instalacji interfejsu wiersza polecenia platformy Azure. Pakiet interfejsu wiersza polecenia platformy Azure wymaga systemu macOS 13 lub nowszego.

Bieżąca wersja interfejsu wiersza polecenia platformy Azure to 2.81.0. Aby uzyskać informacje o najnowszej wersji, zobacz informacje o wersji. Aby znaleźć zainstalowaną wersję i sprawdzić, czy chcesz ją zaktualizować, uruchom polecenie az version.

Instalowanie za pomocą oprogramowania Homebrew

Oprogramowanie Homebrew to najprostszy sposób zarządzania instalacją interfejsu wiersza polecenia platformy Azure. Zapewnia ono wygodne metody instalowania, aktualizowania i odinstalowywania. Jeśli oprogramowanie Homebrew nie jest dostępne w systemie, zainstaluj je przed kontynuowaniem.

Azure CLI można zainstalować w systemie macOS, aktualizując informacje o repozytorium brew, a następnie uruchamiając polecenie install:

brew update && brew install azure-cli

Rozwiązywanie problemów

Jeśli wystąpi problem podczas instalowania interfejsu wiersza polecenia platformy Azure za pośrednictwem oprogramowania Homebrew, poniżej przedstawiono niektóre typowe błędy. Jeśli wystąpi problem, który nie został opisany w tym miejscu, zgłoś problem w usłudze GitHub.

Autouzupełnianie nie działa

Formuła Homebrew Azure CLI instaluje plik uzupełnień o nazwie az w katalogu uzupełnień zarządzanym przez Homebrew (domyślna lokalizacja to /usr/local/etc/bash_completion.d/). Aby włączyć uzupełnianie, postępuj zgodnie z instrukcjami Homebrew tutaj.

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. Interfejs wiersza polecenia platformy Azure nie używa środowiska wirtualnego języka Python, dlatego opiera się na znalezieniu zainstalowanej wersji języka Python. Możliwe rozwiązanie polega na zainstalowaniu i ponownym połączeniu zależności python@3.10 z oprogramowania Homebrew.

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

Zainstalowano interfejs wiersza polecenia platformy Azure w wersji 1.x

Jeśli zainstalowano nieaktualną wersję, może to być spowodowane nieaktualną pamięcią podręczną oprogramowania Homebrew. Postępuj zgodnie z instrukcjami aktualizacji.

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żne

Jeśli jesteś za serwerem proxy, HTTP_PROXY i HTTPS_PROXY muszą być skonfigurowane, aby połączyć się z usługami platformy 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

Aktualizacja

Interfejs wiersza polecenia platformy Azure jest regularnie aktualizowany przy użyciu poprawek błędów, ulepszeń, nowych funkcji i funkcji w wersji zapoznawczej. Nowa wersja jest dostępna około raz w miesiącu.

Począwszy od wersji 2.11.0, interfejs wiersza polecenia platformy Azure udostępnia polecenie w narzędziu umożliwiające aktualizację do najnowszej wersji.

az upgrade

To polecenie aktualizuje również domyślnie wszystkie zainstalowane rozszerzenia. Aby uzyskać więcej az upgrade opcji, zobacz stronę dokumentacji poleceń. W przypadku wersji interfejsu wiersza polecenia platformy Azure wcześniejszych niż 2.11.0 zaktualizuj ją ponownie, ponownie instalując ją zgodnie z opisem w temacie Instalowanie interfejsu wiersza polecenia platformy Azure.

Możesz również zaktualizować lokalne repozytorium Homebrew, a następnie uaktualnić pakiet azure-cli.

brew update && brew upgrade azure-cli

Odinstalowywanie

Jeśli zdecydujesz się odinstalować Azure CLI, przykro nam, że odchodzisz. Przed odinstalowaniem użyj polecenia az feedback, aby poinformować nas, co można ulepszyć lub naprawić. Naszym celem jest zapewnienie, że interfejs wiersza polecenia platformy Azure będzie bezbłędny i przyjazny dla użytkownika. Jeśli znajdziesz usterkę, będziemy wdzięczni za zgłoszenie problemu w usłudze GitHub.

Użyj Homebrew, aby odinstalować pakiet azure-cli.

brew uninstall azure-cli

Usuwanie danych

Jeśli nie planujesz ponownej instalacji interfejsu wiersza polecenia platformy Azure, usuń jego dane.

rm -rf ~/.azure

Inne metody instalacji

Jeśli nie możesz użyć oprogramowania homebrew do zainstalowania interfejsu wiersza polecenia platformy Azure w środowisku, można użyć instrukcji ręcznych dla systemu Linux. Ten proces nie jest oficjalnie obsługiwany w celu zachowania zgodności z systemem macOS. Zaleca się używanie menedżera pakietów, takiego jak Homebrew. Użyj metody instalacji ręcznej tylko wtedy, gdy nie masz innej opcji.

Aby uzyskać instrukcje dotyczące ręcznej instalacji, zobacz Ręczne instalowanie interfejsu wiersza polecenia platformy Azure w systemie Linux.

Dalsze kroki

Po zainstalowaniu interfejsu wiersza polecenia platformy Azure w systemie macOS zapoznaj się z jej funkcjami i typowymi poleceniami.

Rozpoczynanie pracy z interfejsem wiersza polecenia platformy Azure