Instalowanie Azure CLI w systemie Linux

W tym artykule wyjaśniono, jak zainstalować Azure CLI w systemie Linux. Wybierz odpowiedniego menedżera pakietów dla dystrybucji z opcji w górnej części strony. Zaleca się korzystanie z menedżera pakietów dystrybucji systemu Linux.

Bieżąca wersja Azure CLI to 2.84.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.

Zanim rozpoczniesz

• Azure CLI 2.38.2 (wydana 21 czerwca 2024 r.) jest ostatnią wersją obsługiwaną w systemach RHEL 7 i Centos 7. Firma Microsoft nie udostępnia już aktualizacji ani poprawek błędów dla tych dystrybucji.

• yum Użyj menedżera pakietów, jeśli używasz systemu Linux, który nie obsługuje dnf menedżera pakietów.

Instalowanie Azure CLI

Aby zainstalować Azure CLI, wykonaj następujące kroki:

1. Zaimportuj klucz repozytorium firmy Microsoft. W przypadku systemów RHEL 10 i CentOS Stream 10,

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

   W przypadku wersji niższych użyj następującego polecenia:

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

2. W przypadku systemu RHEL 10 dodaj packages-microsoft-com-prod repozytorium:

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

   W przypadku CentOS Stream 10 dodaj repozytorium packages-microsoft-com-prod:

   sudo dnf install -y https://packages.microsoft.com/config/centos/10/packages-microsoft-prod.rpm
   

   W przypadku 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 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 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
   

   Ostrzeżenie

   Koniec okresu wsparcia dla CentOS 7 upłynął 30 czerwca 2024 r. Aby uzyskać informacje na temat obsługiwane środowiska Azure CLI, zobacz cykl życia wsparcia Azure CLI

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

   sudo dnf install azure-cli
   

Instalowanie określonej wersji

Informacje o repozytorium azure-cli należy najpierw skonfigurować, jak pokazano wcześniej. Dostępne wersje można znaleźć w informacjach o wydaniu Azure CLI.

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
   

Aktualizowanie Azure CLI

Począwszy od wersji 2.11.0 Azure CLI 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 Azure CLI wcześniejszych niż 2.11.0 należy przeprowadzić ponowną instalację zgodnie z opisem w Instaluj Azure CLI.

Można również zaktualizować Azure CLI za pomocą polecenia dnf update.

sudo dnf update azure-cli

Odinstalowywanie Azure CLI

Jeśli zdecydujesz się odinstalować Azure CLI, jest nam przykro, że odchodzisz. Przed odinstalowaniem użyj polecenia az feedback, aby poinformować nas, co można ulepszyć lub naprawić. Naszym celem jest uczynienie Azure CLI bez usterek i przyjazną dla użytkownika. Jeśli znalazłeś usterkę, będziemy wdzięczni, jeśli zgłosisz problem na GitHubie.

1. Usuń pakiet z systemu.

   sudo dnf remove azure-cli
   

2. Jeśli nie planujesz ponownego zainstalowania CLI, usuń dane 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
   

Usuwanie danych

Jeśli nie planujesz ponownej instalacji Azure CLI, usuń jego dane.

rm -rf ~/.azure

Rozwiązywanie problemów

Poniżej przedstawiono niektóre typowe problemy, które występują podczas instalacji za pomocą dnf. Jeśli napotkasz problem, który nie został tu uwzględniony, zgłoś problem na GitHubie.

Instalowanie w systemach RHEL 7.6 lub innych bez Python 3

Jeśli jest możliwe, uaktualnij system do wersji z oficjalną obsługą python 3.6+ pakietu. W przeciwnym razie należy najpierw zainstalować pakiet python3, a następnie zainstalować Azure CLI bez zależności.

Możesz użyć następującego polecenia, aby pobrać i zainstalować skrypt instalacji Azure CLI za pomocą python 3.6 skompilowany ze źródła:

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

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

Najpierw Azure CLI wymaga SSL 1.1+ i należy skompilować openssl 1.1 ze źródła przed utworzeniem 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 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 install aby dodać repozytorium Azure CLI. Teraz możesz pobrać pakiet i zainstalować go bez zależności.

Uwaga / Notatka

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

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

Alternatywnie można również zainstalować Python 3 przy użyciu innego repozytorium. Użyj tej metody, jeśli skonfigurowaliśmy element python3 , 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 ustawiłeś zmienne HTTP_PROXY i HTTPS_PROXY w swojej powłoce. Musisz skontaktować się z administratorem systemu, aby wiedzieć, jakich hostów i portów używać dla tych serwerów proxy.

Wartości w tych zmiennych są używane przez wiele programów systemu Linux i podczas procesu instalacji. Aby ustawić te 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, aby łączyć się z usługami Azure za pomocą CLI. Jeśli nie używasz podstawowego uwierzytelniania, zaleca się wyeksportowanie tych zmiennych w .bashrc pliku. Zawsze przestrzegaj zasad zabezpieczeń firmy i wymagań administratora systemu.

Możesz również jawnie skonfigurować dnf , aby zawsze używać tego serwera proxy. Upewnij się, że następujące wiersze pojawiają się w sekcji [main]/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ć CLI w Windows Subsystem for Linux.

Ponieważ Windows Subsystem for Linux (WSL) to warstwa translacji wywołań systemowych na platformie Windows, może wystąpić błąd podczas próby zainstalowania lub uruchomienia Azure CLI. 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 duża szansa, że wystąpi problem z usługą WSL, a nie z procesem instalacji interfejsu wiersza polecenia.

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

• Jeśli możesz, uruchom identyczny proces instalacji na maszynie z systemem Linux lub maszynie wirtualnej, aby sprawdzić, czy się powiedzie. Jeśli tak się stanie, problem prawdopodobnie jest związany z WSL. Aby uruchomić maszynę wirtualną z systemem Linux w Azure, zobacz dokumentację tworzenie maszyny wirtualnej z systemem Linux w portalu Azure.
• Upewnij się, że używasz najnowszej wersji programu WSL. Aby uzyskać najnowszą wersję, aktualizuj instalację Windows 10.
• Sprawdź, czy nie występują otwarte problemy z usługą WSL, które mogą rozwiązać twój problem. Często istnieją sugestie dotyczące sposobu obejścia problemu lub informacji o wydaniu, w którym problem został rozwiązany.
• Jeśli nie ma istniejących zgłoszeń dotyczących Twojego problemu, zgłoś nowy problem do usługi WSL i upewnij się, że dołączasz jak najwięcej informacji.

Jeśli nadal występują problemy z instalowaniem lub uruchamianiem w programie WSL, rozważ instalowanie interfejsu wiersza polecenia dla Windows.

Zanim rozpoczniesz

• Azure CLI 2.38.2 (wydana 21 czerwca 2024 r.) to najnowsza wersja obsługiwana w systemach SUSE Linux Enterprise Server (SLES) i OpenSUSE (Leap). Firma Microsoft nie udostępnia już aktualizacji ani poprawek błędów dla tych dystrybucji.

• SUSE utrzymuje i wspiera pakiety dostarczane przez repozytoria SUSE/OpenSUSE.

• W Azure maszyny wirtualne SUSE i OpenSUSE oparte na obrazach Azure Marketplace mają już zainstalowane Azure CLI.

Instalowanie Azure CLI

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

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

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

3. Instalowanie z repozytoriów firmy Microsoft

Instalowanie z repozytoriów SUSE lub OpenSUSE

Pakiet RPM Azure CLI zależy od pakietu python3.

sudo zypper install -y azure-cli

Instalowanie z repozytoriów firmy Microsoft

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

(Ten pakiet został przetestowany z 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. Stwó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 zypper i zainstaluj:

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

   Wprowadź 2, aby kontynuować instalację, ignorując niektóre zależności.

Instalowanie określonej wersji

Informacje o repozytorium azure-cli należy najpierw skonfigurować, jak pokazano wcześniej. Dostępne wersje można znaleźć w informacjach o wydaniu Azure CLI.

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
   

Aktualizowanie Azure CLI

Począwszy od wersji 2.11.0 Azure CLI 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 Azure CLI wcześniejszych niż 2.11.0 należy przeprowadzić ponowną instalację zgodnie z opisem w Instaluj Azure CLI.

Pakiet można również zaktualizować poleceniem zypper update.

sudo zypper refresh
sudo zypper update azure-cli

Odinstalowywanie Azure CLI

Jeśli zdecydujesz się odinstalować Azure CLI, jest nam przykro, że odchodzisz. Przed odinstalowaniem użyj polecenia az feedback, aby poinformować nas, co można ulepszyć lub naprawić. Naszym celem jest uczynienie Azure CLI bez usterek i przyjazną dla użytkownika. Jeśli znalazłeś usterkę, będziemy wdzięczni, jeśli zgłosisz problem na GitHubie.

1. Usuń pakiet z systemu.

   sudo zypper remove -y azure-cli
   

2. Jeśli nie planujesz ponownego zainstalowania CLI, usuń dane 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
   

Usuwanie danych

Jeśli nie planujesz ponownej instalacji Azure CLI, usuń jego dane.

rm -rf ~/.azure

Rozwiązywanie problemów

Poniżej przedstawiono niektóre typowe problemy, które występują podczas instalacji za pomocą zypper. Jeśli napotkasz problem, który nie został tu uwzględniony, zgłoś problem na GitHubie.

Instalowanie bez Python 3

Ważne

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

Należy pamiętać, że Python 2 osiągnął koniec życia (EOL) 1 stycznia 2020 r. i nie będzie już otrzymywać aktualizacji. Azure CLI przestało obsługiwać Python 2.7 od wersji 2.1.0. Nowsze wersje interfejsu wiersza polecenia mogą nie działać poprawnie przy użyciu Python 2.7.

NotImplementedError na wirtualnej maszynie OpenSUSE 15

Maszyna wirtualna OpenSUSE 15 ma wstępnie zainstalowaną Azure CLI z wersją 2.0.45, która jest nieaktualna i ma problemy z az login. Usuń tę wersję wraz z jej zależnościami przed wykonaniem instrukcji Install aby dodać najnowszą Azure CLI:

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

Jeśli zaktualizowano Azure CLI bez usuwania zależności wersji 2.0.45, jej stare zależności mogą mieć wpływ na najnowszą wersję Azure CLI. Musisz dodać starą wersję, aby połączyć ją z jej zależnościami, a następnie usunąć azure-cli razem z ich 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

Zainstaluj na systemach SLES 12 lub innych bez Python 3.6

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

Możesz użyć następującego polecenia, aby zainstalować lub zaktualizować Azure CLI na podstawie powyższych kroków. Skrypt instaluje Python 3.8 w /usr/local/azcli i Azure CLI go używa, ustawiając alias az na PATH=/usr/local/azcli/bin:$PATH az. Możesz również pobrać skrypt i zmodyfikować go zgodnie z potrzebami. Można na przykład zmienić Python wersję 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 ustawiłeś zmienne HTTP_PROXY i HTTPS_PROXY w swojej powłoce. Musisz skontaktować się z administratorem systemu, aby wiedzieć, jakich hostów i portów używać dla tych serwerów proxy.

Wartości w tych zmiennych są używane przez wiele programów systemu Linux i podczas procesu instalacji. Aby ustawić te 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, aby łączyć się z usługami Azure za pomocą CLI. Jeśli nie używasz podstawowego uwierzytelniania, 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 yast2 tak, aby zawsze używał tego serwera proxy. W tym celu uruchom polecenie yast2 proxy jako użytkownik główny i uzupełnij dane przedstawione w formularzu. Jeśli masz menedżera okien dostępnego w systemie, 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ć CLI w Windows Subsystem for Linux.

Ponieważ Windows Subsystem for Linux (WSL) to warstwa translacji wywołań systemowych na platformie Windows, może wystąpić błąd podczas próby zainstalowania lub uruchomienia Azure CLI. 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 duża szansa, że wystąpi problem z usługą WSL, a nie z procesem instalacji interfejsu wiersza polecenia.

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

• Jeśli możesz, uruchom identyczny proces instalacji na maszynie z systemem Linux lub maszynie wirtualnej, aby sprawdzić, czy się powiedzie. Jeśli tak się stanie, problem prawdopodobnie jest związany z WSL. Aby uruchomić maszynę wirtualną z systemem Linux w Azure, zobacz dokumentację tworzenie maszyny wirtualnej z systemem Linux w portalu Azure.
• Upewnij się, że używasz najnowszej wersji programu WSL. Aby uzyskać najnowszą wersję, aktualizuj instalację Windows 10.
• Sprawdź, czy nie występują otwarte problemy z usługą WSL, które mogą rozwiązać twój problem. Często istnieją sugestie dotyczące sposobu obejścia problemu lub informacji o wydaniu, w którym problem został rozwiązany.
• Jeśli nie ma istniejących zgłoszeń dotyczących Twojego problemu, zgłoś nowy problem do usługi WSL i upewnij się, że dołączasz jak najwięcej informacji.

Jeśli nadal występują problemy z instalowaniem lub uruchamianiem w programie WSL, rozważ instalowanie interfejsu wiersza polecenia dla 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 dlatego nie może nawiązać bezpiecznego połączenia. Zaktualizuj certyfikat, aby rozwiązać ten problem.

sudo zypper update-ca-certificates

Zanim rozpoczniesz

• Menedżer pakietów apt zawiera pakiety x86_64 i ARM64 dla Azure CLI, które zostały przetestowane w następujących dystrybucjach.

  Dystrybucja	wersja
  Debian	11 (Bullseye), 12 (Bookworm)
  Ubuntu	22.04 (Jammy Jellyfish), 24.04 (Noble Numbat)

Instalowanie Azure CLI

Istnieją dwie opcje instalowania Azure CLI w systemie. Możesz pobrać skrypt instalacji, który uruchamia polecenia instalacji, lub samodzielnie wykonać polecenia instalacji w procesie krok po kroku. Obie metody są dostępne tutaj:

Opcja 1. Instalowanie za pomocą jednego polecenia

Najprostszym sposobem zainstalowania Azure CLI jest skrypt obsługiwany przez zespół Azure CLI. Ten skrypt uruchamia wszystkie polecenia instalacji w jednym kroku. Ten skrypt jest pobierany za pomocą curl i przesyłany bezpośrednio do bash w celu zainstalowania interfejsu wiersza polecenia.

Jeśli chcesz samodzielnie sprawdzić zawartość skryptu przed wykonaniem, najpierw pobierz skrypt za pomocą curl, a następnie sprawdź go w swoim ulubionym edytorze tekstowym.

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ć Azure CLI.

1. Pobierz pakiety potrzebne do procesu instalacji:

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

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 Azure CLI:

   AZ_DIST=$(lsb_release -cs)
   echo "Types: deb
   URIs: https://packages.microsoft.com/repos/azure-cli/
   Suites: ${AZ_DIST}
   Components: main
   Architectures: $(dpkg --print-architecture)
   Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources
   

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 wcześniej. Dostępne wersje można znaleźć w informacjach o wydaniu Azure CLI.

1. Wyświetl dostępne wersje Azure CLI.

   apt-cache policy azure-cli
   

2. Zainstaluj określoną wersję.

   # Obtain the currently installed distribution
   AZ_DIST=$(lsb_release -cs)
   
   # Store an Azure CLI version of choice
   AZ_VER=2.51.0
   
   # Install a specific version
   sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}
   

   Aby zainstalować określoną wersję bez zmiennych, zastąp wyświetlaną Azure CLI wersję i nazwę dystrybucji systemu Linux:

   sudo apt-get install azure-cli=2.51.0-1~bullseye
   

Jeśli zostanie wyświetlony komunikat o błędzie Nie można zlokalizować pakietu azure-cli, azure-cli informacje o repozytorium nie są skonfigurowane. Wykonaj kroki podane w temacie Opcja 2: Instrukcje instalacji krok po kroku.

Jeśli otrzymasz komunikat o błędzie: "Wersja x.xx.x-1~distributionName dla azure-cli nie została znaleziona", użyj polecenia lsb_release -cs, aby znaleźć uruchomioną dystrybucję.

Aktualizowanie Azure CLI

Począwszy od wersji 2.11.0 Azure CLI 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 Azure CLI wcześniejszych niż 2.11.0 należy przeprowadzić ponowną instalację zgodnie z opisem w Instaluj Azure CLI.

Możesz również użyć apt-get upgrade, aby zaktualizować pakiet CLI. To polecenie uaktualnia wszystkie zainstalowane pakiety w systemie, które nie miały zmiany zależności.

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

Aby uaktualnić tylko interfejs wiersza polecenia, użyj apt-get install.

sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli

Odinstalowywanie Azure CLI

Jeśli zdecydujesz się odinstalować Azure CLI, jest nam przykro, że odchodzisz. Przed odinstalowaniem użyj polecenia az feedback, aby poinformować nas, co można ulepszyć lub naprawić. Naszym celem jest uczynienie Azure CLI bez usterek i przyjazną dla użytkownika. Jeśli znalazłeś usterkę, będziemy wdzięczni, jeśli zgłosisz problem na GitHubie.

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

   sudo apt-get remove -y azure-cli
   

2. Jeśli nie planujesz ponownej instalacji interfejsu wiersza polecenia, usuń informacje o repozytorium Azure CLI:

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

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

   sudo rm /etc/apt/keyrings/microsoft.gpg
   

4. Usuń wszystkie niepotrzebne pakiety:

   sudo apt autoremove
   

Usuwanie danych

Jeśli nie planujesz ponownej instalacji Azure CLI, usuń jego dane.

rm -rf ~/.azure

Rozwiązywanie problemów

Poniżej przedstawiono niektóre typowe problemy, które występują podczas instalacji za pomocą apt. Jeśli napotkasz problem, który nie został tu uwzględniony, zgłoś problem na GitHubie.

Pakiet azure-cli obsługuje architekturę ARM64 od wersji 2.46.0 interfejsu wiersza polecenia.

lsb_release nie zwraca prawidłowej podstawowej wersji dystrybucji

Niektóre dystrybucje systemu Ubuntu lub inne dystrybucje pochodne debiana (takie jak Linux Mint) mogą nie zwracać poprawnej nazwy wersji z 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 tę 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 twojej dystrybucji

Czasami zaktualizowany pakiet Azure CLI nie jest natychmiast dostępny po wydaniu wersji dystrybucji. Azure CLI został zaprojektowany, aby zapewniać odporność na przyszłe wersje zależności i opiera się na jak najmniejszej ich liczbie. Jeśli nie ma dostępnego pakietu dla dystrybucji podstawowej, wypróbuj pakiet dla wcześniejszej dystrybucji.

Aby wypróbować pakiet dla wcześniejszej dystrybucji, ustaw 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 bookworm repozytorium:

AZ_REPO="bookworm"

Ważne

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

Elementarny OS (EOS) nie może zainstalować Azure CLI

Nie można zainstalować Azure CLI systemu EOS, ponieważ lsb_release zwraca HERA, czyli nazwę wydania systemu EOS. Rozwiązaniem jest naprawienie pliku /etc/apt/sources.list.d/azure-cli.sources i zmiana Suites: hera na Suites: bionic.

Oryginalna zawartość pliku:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Zmodyfikowana zawartość pliku

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

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 ustawiłeś zmienne HTTP_PROXY i HTTPS_PROXY w swojej powłoce. Musisz skontaktować się z administratorem systemu, aby wiedzieć, jakich hostów i portów używać dla tych serwerów proxy.

Wartości w tych zmiennych są używane przez wiele programów systemu Linux i podczas procesu instalacji. Aby ustawić te 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, aby łączyć się z usługami Azure za pomocą CLI. Jeśli nie używasz podstawowego uwierzytelniania, zaleca się wyeksportowanie tych zmiennych w .bashrc pliku. Zawsze przestrzegaj zasad zabezpieczeń firmy i wymagań administratora systemu.

Możesz również jawnie skonfigurować apt , aby zawsze używać tego serwera proxy. Upewnij się, że następujące wiersze znajdują się w pliku konfiguracji apt/etc/apt/apt.conf.d/. Zalecamy użycie istniejącego pliku konfiguracji globalnej, istniejącego pliku konfiguracji serwera proxy lub 40proxies99local, ale postępuj zgodnie z wymaganiami administrowania systemem.

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ęść URI serwera proxy. Jeśli potrzebujesz więcej informacji na temat konfiguracji serwera proxy, zapoznaj się z oficjalną dokumentacją systemu Ubuntu:

• strona narzędzia apt.conf man
• Wiki Ubuntu - jak używać apt-get

Aby uzyskać klucz podpisywania firmy Microsoft i pobrać 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ć CLI w Windows Subsystem for Linux.

Ponieważ Windows Subsystem for Linux (WSL) to warstwa translacji wywołań systemowych na platformie Windows, może wystąpić błąd podczas próby zainstalowania lub uruchomienia Azure CLI. 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 duża szansa, że wystąpi problem z usługą WSL, a nie z procesem instalacji interfejsu wiersza polecenia.

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

• Jeśli możesz, uruchom identyczny proces instalacji na maszynie z systemem Linux lub maszynie wirtualnej, aby sprawdzić, czy się powiedzie. Jeśli tak się stanie, problem prawdopodobnie jest związany z WSL. Aby uruchomić maszynę wirtualną z systemem Linux w Azure, zobacz dokumentację tworzenie maszyny wirtualnej z systemem Linux w portalu Azure.
• Upewnij się, że używasz najnowszej wersji programu WSL. Aby uzyskać najnowszą wersję, aktualizuj instalację Windows 10.
• Sprawdź, czy nie występują otwarte problemy z usługą WSL, które mogą rozwiązać twój problem. Często istnieją sugestie dotyczące sposobu obejścia problemu lub informacji o wydaniu, w którym problem został rozwiązany.
• Jeśli nie ma istniejących zgłoszeń dotyczących Twojego problemu, zgłoś nowy problem do usługi WSL i upewnij się, że dołączasz jak najwięcej informacji.

Jeśli nadal występują problemy z instalowaniem lub uruchamianiem w programie WSL, rozważ instalowanie interfejsu wiersza polecenia dla Windows.

Instalowanie Azure CLI

Pakiety RPM są wydawane dla Azure Linux przez CBL-Mariner. Pakiet azure-cli obsługuje architekturę ARM64 od wersji 2.46.0 interfejsu wiersza polecenia.

Aby zainstalować Azure CLI, wykonaj następujące kroki:

1. Zainstaluj oficjalny zestaw starannie dobranych zaufanych certyfikatów głównych firmy Microsoft.

   sudo tdnf install ca-certificates
   

2. Zainstaluj Azure CLI:

   sudo tdnf install azure-cli
   

Instalowanie określonej wersji

Dostępne wersje można znaleźć w informacjach o wydaniu Azure CLI.

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

Aktualizowanie Azure CLI

Zaktualizuj Azure CLI za pomocą polecenia tdnf update:

sudo tdnf update azure-cli

Odinstalowywanie Azure CLI

Jeśli zdecydujesz się odinstalować Azure CLI, jest nam przykro, że odchodzisz. Przed odinstalowaniem użyj polecenia az feedback, aby poinformować nas, co można ulepszyć lub naprawić. Naszym celem jest uczynienie Azure CLI bez usterek i przyjazną dla użytkownika. Jeśli znalazłeś usterkę, będziemy wdzięczni, jeśli zgłosisz problem na GitHubie.

Usuń pakiet z systemu:

sudo tdnf remove azure-cli

Usuwanie danych

Jeśli nie planujesz ponownej instalacji Azure CLI, usuń jego dane.

rm -rf ~/.azure

Dalsze kroki

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

Rozpocznij pracę z Azure CLI