Instalowanie interfejsu wiersza polecenia platformy Azure w systemie macOS

Interfejs wiersza polecenia platformy Azure umożliwia wykonywanie poleceń za pośrednictwem terminalu przy użyciu interakcyjnych wierszy polecenia lub skryptu. Interfejs wiersza polecenia platformy Azure można zainstalować lokalnie na komputerach z systemem macOS. Interfejs wiersza polecenia platformy Azure w systemie macOS umożliwia wykonywanie różnych poleceń za pośrednictwem terminalu przy użyciu interakcyjnych wierszy polecenia lub skryptu.

W przypadku platformy macOS interfejs wiersza polecenia platformy Azure można zainstalować za pomocą menedżera pakietów oprogramowania Homebrew. Oprogramowanie Homebrew ułatwia zapewnienie aktualności instalacji interfejsu wiersza polecenia. Pakiet interfejsu wiersza polecenia został przetestowany w systemie macOS w wersji 10.9 i nowszych.

Bieżąca wersja interfejsu wiersza polecenia platformy Azure to 2.60.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 udostępnia najprostszy sposób zarządzania instalacją interfejsu wiersza polecenia. Zapewnia ono wygodne metody instalowania, aktualizowania i odinstalowywania. Jeśli oprogramowanie Homebrew nie jest dostępne w systemie, zainstaluj je przed kontynuowaniem.

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

brew update && brew install azure-cli

Rozwiązywanie problemów

Jeśli wystąpi problem podczas instalowania interfejsu wiersza polecenia za pomocą 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.

Ukończenie nie działa

Formuła oprogramowania Homebrew interfejsu wiersza polecenia platformy Azure instaluje plik uzupełniania o nazwie az w katalogu uzupełniania zarządzanego przez oprogramowanie Homebrew (domyślna lokalizacja to /usr/local/etc/bash_completion.d/). Aby włączyć uzupełnianie, postępuj zgodnie z instrukcjami oprogramowania Homebrew tutaj.

W polu Zsh dodaj następujące dwa wiersze w dolnej części .zshrc pliku, a następnie zapisz i załaduj ponownie profil Zsh.

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

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

Być może podczas instalacji oprogramowania Homebrew wystąpiła drobna niezgodność wersji pomocniczej lub inny problem. Interfejs wiersza polecenia nie używa środowiska wirtualnego języka Python, dlatego opiera się na znajdowaniu 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

Jest zainstalowany interfejs wiersza polecenia 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 prawidłowo skonfigurowano go do korzystania z serwera proxy. Postępuj zgodnie z instrukcjami konfiguracji serwera proxy oprogramowania Homebrew.

Ważne

Jeśli używasz serwera proxy HTTP_PROXY i HTTPS_PROXY musisz skonfigurować połączenie z usługami platformy Azure za pomocą interfejsu wiersza polecenia. Jeśli nie używasz podstawowego uwierzytelniania, zaleca się wyeksportowanie tych zmiennych 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

Zaktualizuj

Interfejs wiersza polecenia jest regularnie aktualizowany za pomocą poprawek błędów, ulepszeń, nowych funkcji i funkcji podglądu. Nowa wersja jest dostępna mniej więcej co trzy tygodnie.

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ę referencyjną 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ć informacje o lokalnym repozytorium Oprogramowania Homebrew, a następnie uaktualnić azure-cli pakiet.

brew update && brew upgrade azure-cli

Odinstaluj program

Jeśli zdecydujesz się odinstalować interfejs wiersza polecenia platformy Azure, będzie nam przykro, że nas opuszczasz. 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.

Odinstaluj pakiet azure-cli za pomocą oprogramowania Homebrew.

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. Korzystanie z menedżera pakietów, takiego jak Homebrew, jest zawsze zalecane. 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.

Następne kroki

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