Instalowanie interfejsu wiersza polecenia platformy Azure w systemie macOS

Interfejs azure Command-Line (CLI) umożliwia wykonywanie poleceń za pośrednictwem terminalu przy użyciu interaktywnych 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 interaktywnych 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.39.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

Ważne

Interfejs wiersza polecenia platformy Azure ma zależność od pakietu Homebrew python@3.10 i zainstaluje go.

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 masz problem, który nie został opisany w tym miejscu, zgłoś go w serwisie github.

Ukończenie nie działa

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

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 Homebrew, chyba że poprawnie skonfigurowano je do korzystania z serwera proxy. Postępuj zgodnie z instrukcjami konfiguracji serwera proxy Homebrew.

Ważne

Jeśli jesteś za serwerem proxy i HTTP_PROXYHTTPS_PROXY musisz ustawić 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 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 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.

Interfejs wiersza polecenia udostępnia polecenie w narzędziu umożliwiające aktualizację do najnowszej wersji:

az upgrade

Uwaga

az upgrade Polecenie zostało dodane w wersji 2.11.0 i nie będzie działać z wersjami wcześniejszymi niż 2.11.0. Starsze wersje można zaktualizować, zainstaluj ponownie zgodnie z opisem w temacie Instalowanie interfejsu wiersza polecenia platformy Azure.

To polecenie spowoduje również aktualizację wszystkich zainstalowanych rozszerzeń domyślnie. Aby uzyskać więcej az upgrade opcji, zapoznaj się ze stroną referencyjną poleceń.

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

brew update && brew upgrade azure-cli

Dezinstalacja

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. Należy pamiętać, że ten proces nie jest oficjalnie utrzymywany jako zgodny 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 instalacji ręcznej, 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 krótkim przewodnikiem po jego funkcjach i typowych poleceniach.