Instalowanie interfejsu wiersza polecenia platformy Azure w systemie Linux

  • Artykuł

Interfejs wiersza polecenia platformy Azure to międzyplatformowe narzędzie wiersza polecenia, które można zainstalować lokalnie na komputerach z systemem Linux. Interfejs wiersza polecenia platformy Azure w systemie Linux umożliwia nawiązywanie połączenia z platformą Azure i wykonywanie poleceń administracyjnych w zasobach platformy Azure. Interfejs wiersza polecenia w systemie Linux umożliwia wykonywanie różnych poleceń za pośrednictwem terminalu przy użyciu interaktywnych wierszy polecenia lub skryptu. Gdy wszystko będzie gotowe do zainstalowania interfejsu wiersza polecenia platformy Azure w systemie Linux, zaleca się użycie menedżera pakietów dystrybucji systemu Linux. Wybierz odpowiedniego menedżera pakietów dla twojej dystrybucji z powyższych opcji. Jeśli nie masz jednego z wymienionych menedżerów pakietów, możesz ręcznie zainstalować interfejs wiersza polecenia platformy Azure w systemie Linux, wybierając opcję Zainstaluj skrypt .

Bieżąca wersja interfejsu wiersza polecenia platformy Azure to 2.49.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.

Omówienie

W przypadku dystrybucji systemu Linux z dnfsystemem , takich jak RHEL 8/9 lub CentOS Stream 8/9, istnieją pakiety RPM dla interfejsu wiersza polecenia platformy Azure.

Ostrzeżenie

Interfejs wiersza polecenia platformy Azure w wersji 2.39.0 (wydany w dniu 08.02.2022 r.) jest ostatnią wersją obsługiwaną w systemach RHEL 7 i Centos 7 i będzie nadal otrzymywać poprawki zabezpieczeń do końca życia systemów operacyjnych. Firma Microsoft nie udostępni żadnych innych aktualizacji ani poprawek usterek w tej wersji.

Interfejs wiersza polecenia platformy Azure i skrypt instalacji systemu Linux będą nadal opracowywane i obsługiwane przez firmę Microsoft. Pakiety dostarczane przez repozytoria Red Hat i CentOS są obsługiwane przez odpowiednie dystrybucje.

Bieżąca wersja interfejsu wiersza polecenia platformy Azure to 2.49.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.

Ważne

Pakiet RPM interfejsu wiersza polecenia platformy python3 Azure zależy od pakietu. W systemie może to być wersja języka Python, która poprzedza wymaganie języka Python w wersji 3.6.x. Jeśli to wpłynie na Ciebie, znajdź pakiet zastępczy python3 .

Należy pamiętać, że 1 stycznia 2020 r. język Python 2 osiągnął koniec życia (EOL) i nie będzie już otrzymywać aktualizacji. Interfejs wiersza polecenia platformy Azure zrezygnował z obsługi języka Python 2.7 od wersji 2.1.0. Nowsze wersje mogą nie działać poprawnie przy użyciu języka Python 2.7.

Uwaga

yum Użyj menedżera pakietów, jeśli używasz systemów Linux, które nie obsługują dnf menedżera pakietów.

Uwaga

Pakiet azure-cli obsługuje architekturę ARM64 z systemu 2.46.0.

Instalowanie

  1. Zaimportuj klucz repozytorium firmy Microsoft.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

  2. W przypadku systemu RHEL 9 lub CentOS Stream 9 dodaj packages-microsoft-com-prod repozytorium:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm

    W przypadku systemu RHEL 8 lub CentOS Stream 8 dodaj packages-microsoft-com-prod repozytorium:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm

    W przypadku systemu RHEL 7 lub CentOS 7 dodaj azure-cli repozytorium:

    echo -e "[azure-cli]
name=Azure CLI
baseurl=https://packages.microsoft.com/yumrepos/azure-cli
enabled=1
gpgcheck=1
gpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/azure-cli.repo

  3. Przeprowadź instalację przy użyciu polecenia dnf install.

    sudo dnf install azure-cli

Instalowanie określonej wersji

Najpierw należy skonfigurować azure-cli informacje o repozytorium, jak pokazano powyżej. Dostępne wersje można znaleźć w temacie Informacje o wersji interfejsu wiersza polecenia platformy Azure.

  1. Aby wyświetlić dostępne wersje za pomocą polecenia :

    dnf list --showduplicates azure-cli

  2. Aby zainstalować określoną wersję:

    sudo dnf install azure-cli-<version>-1.el7

Rozwiązywanie problemów

Poniżej przedstawiono niektóre typowe problemy, które występują podczas instalacji za pomocą dnf. Jeśli wystąpi problem, który nie został tutaj omówiony, zgłoś problem w usłudze GitHub.

Instalowanie w systemach RHEL 7.6 lub innych bez języka Python 3

Jeśli jesteś w stanie, uaktualnij system do wersji z oficjalną obsługą python 3.6+ pakietu. W przeciwnym razie należy najpierw zainstalować python3 pakiet, a następnie zainstalować interfejs wiersza polecenia platformy Azure bez zależności.

Aby pobrać i zainstalować skrypt instalacji interfejsu wiersza polecenia platformy Azure z python 3.6 skompilowany ze źródła, możesz użyć następującego polecenia:

curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

Możesz również wykonać to krok po kroku:

Najpierw interfejs wiersza polecenia platformy Azure wymaga SSL 1.1+ kompilacji openssl 1.1 ze źródła przed utworzeniem polecenia python3:

sudo dnf install gcc gcc-c++ make ncurses patch wget tar zlib zlib-devel -y
# build openssl from source
cd ~
wget https://www.openssl.org/source/openssl-1.1.1d.tar.gz
tar -xzf openssl-1.1.1d.tar.gz
cd openssl-1.1.1d
./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl
make
sudo make install
# configure shared object lookup directory so that libssl.so.1.1 can be found
echo "/usr/local/ssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1d.conf
# reload config
sudo ldconfig -v

Następnie skompiluj środowisko Python 3 ze źródła:

PYTHON_VERSION="3.6.9"
PYTHON_SRC_DIR=$(mktemp -d)
wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
cd $PYTHON_SRC_DIR/Python-$PYTHON_VERSION
./configure --prefix=/usr --with-openssl=/usr/local/ssl
make
sudo make install

Na koniec wykonaj kroki 1 i 2 instrukcji instalacji , aby dodać repozytorium interfejsu wiersza polecenia platformy Azure. Teraz możesz pobrać pakiet i zainstalować go bez zależności.

Uwaga

Jeśli wtyczka pobierania systemu plików dnf nie jest jeszcze zainstalowana, podczas wykonywania poniższego kodu wystąpi command not found błąd. Użyj polecenia dnf install 'dnf-command(download)' , aby zainstalować wtyczkę pobierania dnf.

sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm

Alternatywnie możesz również zainstalować środowisko Python 3 przy użyciu dodatkowego repozytorium. Użyj tej metody, jeśli skonfigurowaliśmy python3 element , ale nadal występuje błąd python3: command not found. Upewnij się, że został on uwzględniony w ścieżce.

scl enable rh-python36 bash

Serwer proxy blokuje połączenie

Jeśli nie możesz nawiązać połączenia z zasobem zewnętrznym z powodu serwera proxy, upewnij się, że poprawnie ustawiono HTTP_PROXY zmienne i HTTPS_PROXY w powłoce. Skontaktuj się z administratorem systemu, aby wiedzieć, jakich hostów i portów należy użyć dla tych serwerów proxy.

Te wartości są przestrzegane przez wiele programów systemu Linux, w tym te, które są używane w procesie instalacji. Aby ustawić następujące wartości:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

Ważne

Jeśli używasz serwera proxy, te zmienne powłoki muszą być ustawione tak, aby łączyły się z usługami platformy Azure za pomocą interfejsu wiersza polecenia. Jeśli nie używasz uwierzytelniania podstawowego, zaleca się wyeksportowanie tych zmiennych w .bashrc pliku. Zawsze przestrzegaj zasad zabezpieczeń firmy i wymagań administratora systemu.

Możesz również jawnie skonfigurować dnf używanie tego serwera proxy przez cały czas. Upewnij się, że następujące wiersze są wyświetlane w [main] sekcji :/etc/dnf/dnf.conf

[main]
# ...
proxy=http://[proxy]:[port] # If your proxy requires https, change http->https
proxy_username=[username] # Only required for basic auth
proxy_password=[password] # Only required for basic auth

Aby uzyskać klucz podpisywania firmy Microsoft i pakiet z naszego repozytorium, serwer proxy musi zezwolić na połączenia HTTPS z następującym adresem:

  • https://packages.microsoft.com

Nie można zainstalować ani uruchomić interfejsu wiersza polecenia w Podsystem Windows dla systemu Linux

Ponieważ Podsystem Windows dla systemu Linux (WSL) jest warstwą tłumaczenia wywołań systemowych na platformie Windows, może wystąpić błąd podczas próby zainstalowania lub uruchomienia interfejsu wiersza polecenia platformy Azure. Interfejs wiersza polecenia opiera się na niektórych funkcjach, które mogą mieć usterkę w programie WSL. Jeśli wystąpi błąd niezależnie od sposobu instalowania interfejsu wiersza polecenia, istnieje prawdopodobieństwo, że wystąpi problem z usługą WSL, a nie z procesem instalacji interfejsu wiersza polecenia.

Aby rozwiązać problemy z instalacją programu WSL i ewentualnie rozwiązać problemy:

Jeśli nadal masz problemy z instalacją lub uruchamianiem w programie WSL, rozważ zainstalowanie interfejsu wiersza polecenia dla systemu Windows.

Aktualizacja

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

az upgrade

Uwaga

Polecenie az upgrade 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ć, ponownie instalując je zgodnie z opisem w temacie Instalowanie interfejsu wiersza polecenia platformy Azure.

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

Możesz również zaktualizować interfejs wiersza polecenia platformy Azure za dnf update pomocą polecenia .

sudo dnf update 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.

  1. Usuń pakietu z systemu.

    sudo dnf remove azure-cli

  2. Jeśli nie planujesz ponownego zainstalowania interfejsu wiersza polecenia, usuń informacje o repozytorium.

    sudo rm /etc/yum.repos.d/azure-cli.repo

  3. Jeśli nie używasz żadnych innych pakietów firmy Microsoft, usuń klucz podpisywania.

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY

Ostrzeżenie

Ostatni pakiet interfejsu wiersza polecenia platformy Azure opracowany przez firmę Microsoft dla systemu SUSE Linux Enterprise Server (SLES) i OpenSUSE (Leap) to wersja 2.38.0 (wydana 07.05.2022). W tych systemach można nadal używać historycznych wersji interfejsu wiersza polecenia platformy Azure, ale nie będzie żadnych dalszych aktualizacji ani poprawek usterek firmy Microsoft dla tych wersji.

Interfejs wiersza polecenia platformy Azure i skrypt instalacji systemu Linux będą nadal opracowywane i obsługiwane przez firmę Microsoft. Pakiety dostarczane przez repozytoria SUSE/OpenSUSE są obsługiwane przez system SUSE.

Omówienie

Na platformie Azure maszyny wirtualne SUSE i OpenSUSE oparte na obrazach Azure Marketplace mają już zainstalowany interfejs Azure Command-Line Interface (interfejs wiersza polecenia platformy Azure).

Aby zainstalować interfejs wiersza polecenia platformy Azure w systemie SUSE/OpenSUSE, wybierz jedną z następujących metod:

  1. Użyj pakietu Enterprise dostarczonego przez firmę SUSE w repozytoriach SUSE/OpenSUSE.

  2. Użyj metody instalacji opisanej na karcie "Zainstaluj skrypt (dowolny)".

Zainstaluj interfejs wiersza polecenia platformy Azure

Instalowanie z repozytoriów SUSE lub OpenSUSE

Ważne

Pakiet RPM interfejsu wiersza polecenia platformy python3 Azure zależy od pakietu. W systemie może to być wersja języka Python, która poprzedza wymaganie języka Python w wersji 3.6.x. Jeśli to wpłynie na Ciebie, znajdź pakiet zastępczy python3 .

Należy pamiętać, że 1 stycznia 2020 r. język Python 2 osiągnął koniec życia (EOL) i nie będzie już otrzymywać aktualizacji. Interfejs wiersza polecenia platformy Azure zrezygnował z obsługi języka Python 2.7 od wersji 2.1.0. Nowsze wersje mogą nie działać poprawnie przy użyciu języka Python 2.7.

sudo zypper install -y azure-cli

Instalowanie za pomocą skryptu instalacji

Interfejs wiersza polecenia platformy Azure można zainstalować ręcznie w dowolnej wersji systemu Linux przy użyciu opcji Zainstaluj skrypt .

W przypadku aktualizowania do najnowszej wersji przy użyciu tej metody należy najpierw odinstalować poprzednią wersję, a także wszystkie repozytoria, które mogły zostać dodane dla tej wersji.

Instalowanie z repozytoriów firmy Microsoft

Aby zainstalować najnowszą historyczną wersję interfejsu wiersza polecenia platformy Azure przy użyciu repozytoriów firmy Microsoft, wykonaj następujące kroki.

(Ten pakiet został przetestowany przy użyciu usług SLES 15 i OpenSUSE Leap 15.1)

  1. Zainstaluj program curl:

    sudo zypper install -y curl

  2. Zaimportuj klucz repozytorium firmy Microsoft:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

  3. Utwórz informacje o lokalnym repozytorium azure-cli:

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli

  4. Zaktualizuj indeks pakietów menedżera zypper i zainstaluj:

    sudo zypper install --from azure-cli azure-cli

    Dane wejściowe 2, aby kontynuować instalację, ignorując niektóre z jego zależności.

Instalowanie określonej wersji

Najpierw należy skonfigurować azure-cli informacje o repozytorium, jak pokazano powyżej. Dostępne wersje można znaleźć w informacjach o wersji interfejsu wiersza polecenia platformy Azure.

  1. Wyświetl dostępne wersje przy użyciu tego polecenia:

    zypper search --details --match-exact azure-cli

  2. Aby zainstalować określoną wersję:

    sudo zypper install --from azure-cli azure-cli=<version>-1.el7

Rozwiązywanie problemów

Poniżej przedstawiono niektóre typowe problemy, które występują podczas instalacji za pomocą zypper. Jeśli wystąpi problem, który nie został tutaj omówiony, zgłoś problem w usłudze GitHub.

NotImplementedError na maszynie wirtualnej OpenSUSE 15

Maszyna wirtualna OpenSUSE 15 ma wstępnie zainstalowany interfejs wiersza polecenia platformy Azure w wersji 2.0.45, która jest nieaktualna i ma problemy z programem az login. Usuń tę wersję wraz z jej zależnościami przed wykonaniem instrukcji Instalacji , aby dodać najnowszy interfejs wiersza polecenia platformy Azure:

sudo zypper rm -y --clean-deps azure-cli

Jeśli zaktualizowano interfejs wiersza polecenia platformy Azure bez usuwania zależności wersji 2.0.45, jej stare zależności mogą mieć wpływ na najnowszą wersję interfejsu wiersza polecenia platformy Azure. Musisz dodać poprzednią wersję, aby połączyć jej zależności, a następnie usunąć azure-cli je wraz z jej zależnościami:

# The package name may vary on different system version, run 'zypper --no-refresh info azure-cli' to check the source package format
sudo zypper install --oldpackage azure-cli-2.0.45-4.22.noarch

sudo zypper rm -y --clean-deps azure-cli

Instalowanie w systemach SLES 12 lub innych bez języka Python 3.6

W systemie SLES 12 domyślny python3 pakiet to 3.4 i nie jest obsługiwany przez interfejs wiersza polecenia platformy Azure. Aby dodać repozytorium, możesz najpierw wykonać krok 1–3 instrukcjiazure-cli instalacji. Następnie utwórz wyższą wersję python3 ze źródła. Na koniec możesz pobrać pakiet interfejsu wiersza polecenia platformy Azure i zainstalować go bez zależności.

Możesz użyć następującego polecenia, aby zainstalować lub zaktualizować interfejs wiersza polecenia platformy Azure na podstawie powyższych kroków. Skrypt zainstaluje środowisko Python 3.8 w obszarze /usr/local/azcli i użyje go za pomocą interfejsu az wiersza polecenia platformy Azure, ustawiając alias na PATH=/usr/local/azcli/bin:$PATH azwartość . Możesz również pobrać skrypt i zmodyfikować go zgodnie z potrzebami. Na przykład możesz zmienić wersję języka Python lub lokalizację instalacji.

curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash

Podczas pierwszej instalacji pamiętaj, aby uruchomić następujące polecenie, aby aktywować alias:

source ~/.bashrc

Serwer proxy blokuje połączenie

Jeśli nie możesz nawiązać połączenia z zasobem zewnętrznym z powodu serwera proxy, upewnij się, że poprawnie ustawiono HTTP_PROXY zmienne i HTTPS_PROXY w powłoce. Skontaktuj się z administratorem systemu, aby wiedzieć, jakich hostów i portów należy użyć dla tych serwerów proxy.

Te wartości są przestrzegane przez wiele programów systemu Linux, w tym te, które są używane w procesie instalacji. Aby ustawić następujące wartości:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

Ważne

Jeśli używasz serwera proxy, te zmienne powłoki muszą być ustawione tak, aby łączyły się z usługami platformy Azure za pomocą interfejsu wiersza polecenia. Jeśli nie używasz uwierzytelniania podstawowego, zaleca się wyeksportowanie tych zmiennych w .bashrc pliku. Zawsze przestrzegaj zasad zabezpieczeń firmy i wymagań administratora systemu.

Możesz również jawnie skonfigurować zypper (za pośrednictwem yast2metody ), aby zawsze używać tego serwera proxy. W tym celu uruchom yast2 proxy polecenie jako superużytkownik i wypełnij informacje przedstawione w formularzu. Jeśli w systemie jest dostępny menedżer okien, możesz również użyć okienka Network Services > Proxy w pliku YaST Control Center.

Aby uzyskać zaawansowaną konfigurację lub więcej informacji, zobacz dokumentację konfiguracji serwera proxy OpenSUSE

Aby uzyskać klucz podpisywania firmy Microsoft i pobrać go z naszego repozytorium, serwer proxy musi zezwolić na połączenia HTTPS z następującymi adresami:

  • https://packages.microsoft.com
  • https://download.opensuse.org

Nie można zainstalować ani uruchomić interfejsu wiersza polecenia w Podsystem Windows dla systemu Linux

Ponieważ Podsystem Windows dla systemu Linux (WSL) jest warstwą tłumaczenia wywołań systemowych na platformie Windows, może wystąpić błąd podczas próby zainstalowania lub uruchomienia interfejsu wiersza polecenia platformy Azure. Interfejs wiersza polecenia opiera się na niektórych funkcjach, które mogą mieć usterkę w programie WSL. Jeśli wystąpi błąd niezależnie od sposobu instalowania interfejsu wiersza polecenia, istnieje prawdopodobieństwo, że wystąpi problem z usługą WSL, a nie z procesem instalacji interfejsu wiersza polecenia.

Aby rozwiązać problemy z instalacją programu WSL i ewentualnie rozwiązać problemy:

Jeśli nadal masz problemy z instalacją lub uruchamianiem w programie WSL, rozważ zainstalowanie interfejsu wiersza polecenia dla systemu Windows.

Problem z certyfikatem SSL

Gdy certyfikat jest uszkodzony lub nieaktualny na maszynie, może zostać wyświetlony błąd wskazujący, że program curl nie może zweryfikować zasadności serwera i w związku z tym nie może nawiązać bezpiecznego połączenia. Zaktualizuj certyfikat, aby rozwiązać ten problem.

sudo zypper update-ca-certificates

Aktualizacja

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

az upgrade

Uwaga

Polecenie az upgrade 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ć, ponownie instalując je zgodnie z opisem w temacie Instalowanie interfejsu wiersza polecenia platformy Azure.

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

Pakiet można również zaktualizować za zypper update pomocą polecenia .

sudo zypper refresh
sudo zypper update 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.

  1. Usuń pakietu z systemu.

    sudo zypper remove -y azure-cli

  2. Jeśli nie planujesz ponownego zainstalowania interfejsu wiersza polecenia, usuń informacje o repozytorium.

    sudo zypper removerepo azure-cli

  3. Jeśli nie używasz innych pakietów firmy Microsoft, usuń klucz podpisywania firmy Microsoft.

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY

Omówienie

apt Menedżer pakietów zawiera pakiety x86_64 i ARM64 dla interfejsu wiersza polecenia platformy Azure, które zostały przetestowane w następujących dystrybucjach. Brak pakietu ARM64 dla systemu Ubuntu 18.04.

Dystrybucja Wersja
Ubuntu 18.04 LTS (Bionic Beaver), 20.04 LTS (Ogniskowa Fossa), 22.04 (Jammy Jellyfish)
Debian 10 (Buster), 11 (Bullseye)

Ostrzeżenie

Możesz nadal używać historycznych wersji interfejsu wiersza polecenia platformy Azure w starych systemach, ale nie będzie żadnych aktualizacji ani poprawek usterek. Rozważ uaktualnienie do nowszych wersji systemu Ubuntu lub Debian, aby użyć najnowszego interfejsu wiersza polecenia platformy Azure.

Ostrzeżenie

Ubuntu 20.04 (Focal Fossa) i 20.10 (Groovy Gorilla) zawierają pakiet z wersją 2.0.81 dostarczaną azure-cli przez universe repozytorium. Ten pakiet jest nieaktualny i niezalecane. Jeśli ten pakiet jest zainstalowany, usuń pakiet przed kontynuowaniem, uruchamiając polecenie sudo apt remove azure-cli -y && sudo apt autoremove -y. Aby uzyskać więcej informacji na apt removetemat programu , zobacz Zarządzanie pakietami systemu Ubuntu lub poproś o system ubuntu.

Uwaga

Pakiet azure-cli obsługuje architekturę ARM64 z systemu 2.46.0.

Opcje instalacji

Istnieją dwie opcje instalowania interfejsu wiersza polecenia platformy Azure w systemie. Jeśli wolisz, możesz pobrać skrypt instalacji, który uruchomi polecenia instalacji lub samodzielnie wykonać polecenia instalacji. Poniżej przedstawiono obie metody.

Opcja 1. Instalowanie za pomocą jednego polecenia

Zespół interfejsu wiersza polecenia platformy Azure obsługuje skrypt służący do uruchamiania wszystkich poleceń instalacyjnych w jednym kroku. Ten skrypt jest pobierany za pośrednictwem potoku curl i bezpośrednio w celu bash zainstalowania interfejsu wiersza polecenia.

Jeśli chcesz samodzielnie sprawdzić zawartość skryptu przed jego wykonaniem, po prostu najpierw pobierz skrypt i curl sprawdź go w ulubionym edytorze tekstów.

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Opcja 2. Instrukcje instalacji krok po kroku

Jeśli wolisz proces instalacji krok po kroku, wykonaj następujące kroki, aby zainstalować interfejs wiersza polecenia platformy Azure.

  1. Pobierz pakiety potrzebne do procesu instalacji:

    sudo apt-get update
sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg

  2. Pobierz i zainstaluj klucz podpisywania firmy Microsoft:

    sudo mkdir -p /etc/apt/keyrings
curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
    gpg --dearmor |
    sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null
sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
  3. Dodaj repozytorium oprogramowania interfejsu wiersza polecenia platformy Azure:
    AZ_REPO=$(lsb_release -cs)
echo "deb [arch=`dpkg --print-architecture` signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" |
    sudo tee /etc/apt/sources.list.d/azure-cli.list

  4. Zaktualizuj informacje o repozytorium i zainstaluj azure-cli pakiet:

    sudo apt-get update
sudo apt-get install azure-cli

Instalowanie określonej wersji

azure-cli Skonfiguruj informacje o repozytorium, jak pokazano powyżej. Dostępne wersje można znaleźć w temacie Informacje o wersji interfejsu wiersza polecenia platformy Azure.

  1. Aby wyświetlić dostępne wersje za pomocą polecenia :

    apt-cache policy azure-cli

  2. Aby zainstalować określoną wersję:

    sudo apt-get install azure-cli=<version>-1~bullseye

Rozwiązywanie problemów

Poniżej przedstawiono niektóre typowe problemy, które występują podczas instalacji za pomocą apt. Jeśli masz problem, który nie został opisany w tym miejscu, zgłoś go w serwisie github.

Brak problemu z modułem w systemie Ubuntu 20.04 (ogniskowa)/WSL

Jeśli zainstalowano azure-cli program Focal bez dodawania repozytorium oprogramowania interfejsu wiersza polecenia platformy Azure w kroku 3 instrukcji instalacji ręcznej lub przy użyciu naszego skryptu, mogą wystąpić problemy, takie jak brak modułu o nazwie "decorator" lub "antlr4", ponieważ zainstalowany pakiet jest nieaktualny azure-cli 2.0.81 z focal/universe repozytorium. Najpierw usuń go, uruchamiając polecenie sudo apt remove azure-cli -y && sudo apt autoremove -y, a następnie postępuj zgodnie z powyższymi instrukcjami , aby zainstalować najnowszy azure-cli pakiet.

lsb_release nie zwraca prawidłowej podstawowej wersji dystrybucji

Niektóre dystrybucje pochodzące z systemu Ubuntu lub innego systemu Debian (takie jak Linux Mint) mogą nie zwracać poprawnej nazwy wersji z systemu lsb_release. Ta wartość jest używana w procesie instalacji w celu określenia pakietu do zainstalowania. Jeśli znasz nazwę kodu systemu Ubuntu lub Debian, z której pochodzi twoja dystrybucja, możesz ustawić AZ_REPO wartość ręcznie podczas dodawania repozytorium. W przeciwnym razie wyszukaj informacje dotyczące dystrybucji, aby określić nazwę podstawowego kodu dystrybucji i ustawić AZ_REPO poprawną wartość.

Brak pakietu dla dystrybucji

Czasami zaktualizowany pakiet interfejsu wiersza polecenia platformy Azure nie jest natychmiast dostępny po wydaniu wersji dystrybucji. Interfejs wiersza polecenia platformy Azure został zaprojektowany tak, aby był odporny na przyszłe wersje zależności i polegał na jak najmniejszej ich liczbą. Jeśli nie ma dostępnego pakietu dla dystrybucji podstawowej, wypróbuj pakiet dla wcześniejszej dystrybucji.

W tym celu należy ustawić wartość AZ_REPO ręcznie podczas dodawania repozytorium. W przypadku dystrybucji systemu Ubuntu użyj najnowszego jammy repozytorium:

AZ_REPO="jammy"

W przypadku dystrybucji Debian użyj najnowszego bullseye repozytorium:

AZ_REPO="bullseye"

Ważne

Dystrybucje wydane przed Ubuntu Bionic i Debian Buster nie są obsługiwane.

Nie można zainstalować podstawowego systemu operacyjnego (EOS) w interfejsie wiersza polecenia platformy Azure

Nie można zainstalować interfejsu wiersza polecenia platformy Azure w systemie EOS, ponieważ lsb_release zwraca HERAwartość , czyli nazwę wydania systemu EOS. Rozwiązaniem jest naprawienie pliku /etc/apt/sources.list.d/azure-cli.list i zmiana hera main na bionic main.

Oryginalna zawartość pliku:

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ hera main

Zmodyfikowana zawartość pliku

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ bionic main

Serwer proxy blokuje połączenie

Jeśli nie możesz nawiązać połączenia z zasobem zewnętrznym z powodu serwera proxy, upewnij się, że poprawnie ustawiono HTTP_PROXY zmienne i HTTPS_PROXY w powłoce. Skontaktuj się z administratorem systemu, aby wiedzieć, jakich hostów i portów należy użyć dla tych serwerów proxy.

Te wartości są przestrzegane przez wiele programów systemu Linux, w tym te, które są używane w procesie instalacji. Aby ustawić następujące wartości:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

Ważne

Jeśli używasz serwera proxy, te zmienne powłoki muszą być ustawione tak, aby łączyły się z usługami platformy Azure za pomocą interfejsu wiersza polecenia. Jeśli nie używasz uwierzytelniania podstawowego, zaleca się wyeksportowanie tych zmiennych w .bashrc pliku. Zawsze przestrzegaj zasad zabezpieczeń firmy i wymagań administratora systemu.

Możesz również jawnie skonfigurować apt używanie tego serwera proxy przez cały czas. Upewnij się, że następujące wiersze są wyświetlane w apt pliku konfiguracji w /etc/apt/apt.conf.d/pliku . Zalecamy użycie istniejącego pliku konfiguracji globalnej, istniejącego pliku konfiguracji serwera proxy lub 40proxies99local, ale przestrzegać wymagań administracyjnych systemu.

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

Jeśli serwer proxy nie używa podstawowego uwierzytelniania, usuń[username]:[password]@ część identyfikatora URI serwera proxy. Jeśli potrzebujesz więcej informacji na temat konfiguracji serwera proxy, zapoznaj się z oficjalną dokumentacją systemu Ubuntu:

Aby uzyskać klucz podpisywania firmy Microsoft i pobrać go z naszego repozytorium, serwer proxy musi zezwolić na połączenia HTTPS z następującym adresem:

  • https://packages.microsoft.com

Nie można zainstalować ani uruchomić interfejsu wiersza polecenia w Podsystem Windows dla systemu Linux

Ponieważ Podsystem Windows dla systemu Linux (WSL) jest warstwą tłumaczenia wywołań systemowych na platformie Windows, może wystąpić błąd podczas próby zainstalowania lub uruchomienia interfejsu wiersza polecenia platformy Azure. Interfejs wiersza polecenia opiera się na niektórych funkcjach, które mogą mieć usterkę w programie WSL. Jeśli wystąpi błąd niezależnie od sposobu instalowania interfejsu wiersza polecenia, istnieje prawdopodobieństwo, że wystąpi problem z usługą WSL, a nie z procesem instalacji interfejsu wiersza polecenia.

Aby rozwiązać problemy z instalacją programu WSL i ewentualnie rozwiązać problemy:

Jeśli nadal masz problemy z instalacją lub uruchamianiem w programie WSL, rozważ zainstalowanie interfejsu wiersza polecenia dla systemu Windows.

Aktualizacja

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

az upgrade

Uwaga

Polecenie az upgrade 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ć, ponownie instalując je zgodnie z opisem w temacie Instalowanie interfejsu wiersza polecenia platformy Azure.

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

Można również użyć apt-get upgrade polecenia , aby zaktualizować pakiet interfejsu wiersza polecenia.

sudo apt-get update && sudo apt-get upgrade

Uwaga

To polecenie uaktualni wszystkie pakiety zainstalowane w systemie, dla których nie nastąpiła zmiana zależności. Aby uaktualnić tylko interfejs wiersza polecenia, użyj polecenia apt-get install.

sudo apt-get update && sudo apt-get install --only-upgrade -y 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.

  1. Odinstaluj za pomocą polecenia apt-get remove:

    sudo apt-get remove -y azure-cli

  2. Jeśli nie planujesz ponownego zainstalowania interfejsu wiersza polecenia, usuń informacje o repozytorium interfejsu wiersza polecenia platformy Azure:

    sudo rm /etc/apt/sources.list.d/azure-cli.list

  3. Jeśli nie używasz innych pakietów firmy Microsoft, usuń klucz podpisywania:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg

  4. Usuń wszystkie niepotrzebne pakiety:

    sudo apt autoremove

Omówienie

Maszyny RPM są wydawane dla platformy Azure dla systemu Linux.

Uwaga

Pakiet azure-cli obsługuje architekturę ARM64 z systemu 2.46.0.

Instalowanie

  1. Zainstaluj oficjalny zestaw nadzorowanych przez firmę Microsoft zaufanych certyfikatów głównych:

    sudo tdnf install ca-certificates

  2. Instalowanie interfejsu wiersza polecenia platformy Azure:

    sudo tdnf install azure-cli

Instalowanie określonej wersji

Dostępne wersje można znaleźć w temacie Informacje o wersji interfejsu wiersza polecenia platformy Azure.

Aby wyświetlić dostępne wersje za pomocą polecenia :

tdnf list azure-cli

Aby zainstalować określoną wersję:

sudo tdnf install azure-cli-<version>-1

Aktualizacja

Zaktualizuj interfejs wiersza polecenia platformy Azure za tdnf update pomocą polecenia :

sudo tdnf update 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.

Usuń pakiet z systemu:

sudo tdnf remove azure-cli

Omówienie

Uwaga

Zdecydowanie zaleca się instalowanie interfejsu wiersza polecenia za pomocą menedżera pakietów. Menedżer pakietów zapewnia, że zawsze pobierzesz najnowsze aktualizacje, i gwarantuje stabilność składników interfejsu wiersza polecenia. Zanim zaczniesz ręczną instalację, sprawdź, czy istnieje pakiet dla Twojej dystrybucji.

Interfejs wiersza polecenia wymaga następującego oprogramowania:

Ważne

Interfejs wiersza polecenia platformy Azure zrezygnował z obsługi języka Python 2.7 od wersji 2.1.0. Nowsze wersje mogą nie działać poprawnie przy użyciu języka Python 2.7.

Instalowanie lub aktualizowanie

Zarówno instalowanie, jak i aktualizowanie interfejsu wiersza polecenia platformy Azure wymaga ponownego uruchomienia skryptu instalacji.

curl -L https://aka.ms/InstallAzureCli | bash

Skrypt można również pobrać i uruchomić lokalnie. Może być konieczne ponowne uruchomienie powłoki, aby zmiany zaczęły obowiązywać.

Rozwiązywanie problemów

Poniżej przedstawiono niektóre typowe problemy występujące podczas instalacji ręcznej. Jeśli wystąpi problem, który nie został tutaj omówiony, zgłoś problem w usłudze GitHub.

Błąd polecenia curl „Obiekt przeniesiony”

Jeśli wystąpił błąd polecenia curl dotyczący parametru -L lub komunikat o błędzie zawierający tekst „Obiekt przeniesiony”, spróbuj użyć pełnego adresu URL zamiast przekierowania aka.ms:

curl https://azurecliprod.blob.core.windows.net/install | bash

Nie znaleziono polecenia az

Jeśli nie możesz uruchomić polecenia po instalacji przy użyciu polecenia bash lub zsh, spróbuj wyczyścić pamięć podręczną skrótów poleceń powłoki i sprawdzić, czy problem został rozwiązany.

hash -r

Ten problem może także wystąpić, jeśli nie uruchomiono ponownie powłoki po zakończeniu instalacji. Upewnij się, że lokalizacja polecenia az znajduje się w zmiennej $PATH. Lokalizacja polecenia az to

 <install path>/bin

Serwer proxy blokuje połączenie

Jeśli nie możesz nawiązać połączenia z zasobem zewnętrznym z powodu serwera proxy, upewnij się, że poprawnie ustawiono HTTP_PROXY zmienne i HTTPS_PROXY w powłoce. Skontaktuj się z administratorem systemu, aby wiedzieć, jakich hostów i portów należy użyć dla tych serwerów proxy.

Te wartości są przestrzegane przez wiele programów systemu Linux, w tym te, które są używane w procesie instalacji. Aby ustawić następujące wartości:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

Ważne

Jeśli używasz serwera proxy, te zmienne powłoki muszą być ustawione tak, aby łączyły się z usługami platformy Azure za pomocą interfejsu wiersza polecenia. Jeśli nie używasz uwierzytelniania podstawowego, zaleca się wyeksportowanie tych zmiennych w .bashrc pliku. Zawsze przestrzegaj zasad zabezpieczeń firmy i wymagań administratora systemu.

Aby uzyskać skrypty instalacji, serwer proxy musi zezwolić na połączenia HTTPS z następującymi adresami:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Punkty końcowe używane przez menedżera pakietów dystrybucji (jeśli istnieją) dla pakietów podstawowych

Nie można zainstalować ani uruchomić interfejsu wiersza polecenia w Podsystem Windows dla systemu Linux

Ponieważ Podsystem Windows dla systemu Linux (WSL) jest warstwą tłumaczenia wywołań systemowych na platformie Windows, może wystąpić błąd podczas próby zainstalowania lub uruchomienia interfejsu wiersza polecenia platformy Azure. Interfejs wiersza polecenia opiera się na niektórych funkcjach, które mogą mieć usterkę w programie WSL. Jeśli wystąpi błąd niezależnie od sposobu instalowania interfejsu wiersza polecenia, istnieje prawdopodobieństwo, że wystąpi problem z usługą WSL, a nie z procesem instalacji interfejsu wiersza polecenia.

Aby rozwiązać problemy z instalacją programu WSL i ewentualnie rozwiązać problemy:

Jeśli nadal masz problemy z instalacją lub uruchamianiem w programie WSL, rozważ zainstalowanie interfejsu wiersza polecenia dla systemu Windows.

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.

Interfejs wiersza polecenia można odinstalować bezpośrednio, usuwając pliki z lokalizacji wybranej podczas instalacji. Domyślną lokalizacją instalacji jest katalog główny użytkownika ($HOME).

  1. Usuń zainstalowane pliki interfejsu wiersza polecenia.

    rm -r <install location>/lib/azure-cli
rm <install location>/bin/az

  2. Zmodyfikuj plik $HOME/.bash_profile, aby usunąć następujący wiersz:

    <install location>/lib/azure-cli/az.completion

  3. Jeśli używasz polecenia bash lub zsh, załaduj ponownie pamięć podręczną poleceń powłoki.

    hash -r

Usuwanie danych

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

rm -rf ~/.azure

Następne kroki

Po zainstalowaniu interfejsu wiersza polecenia platformy Azure skorzystaj z krótkiego przewodnika po jego funkcjach i typowych poleceniach.

Rozpocznij pracę z interfejsem wiersza polecenia platformy Azure