Поделиться через


Установка Azure CLI в Linux

В этой статье объясняется, как установить Azure CLI в Linux. Выберите соответствующий диспетчер пакетов для вашего дистрибутива из вариантов в верхней части страницы. Рекомендуется использовать диспетчер пакетов дистрибутива Linux.

Текущая версия Azure CLI — 2.84.0. Сведения о последнем выпуске см. в заметках о выпуске. Чтобы узнать, какая версия установлена и нужно ли ее обновить, выполните команду az version.

Перед тем как начать

  • Azure CLI 2.38.2 (выпущена 21 июня 2024 г.) — последняя версия, поддерживаемая rHEL 7 и Centos 7. Корпорация Майкрософт больше не предоставляет обновления или исправления ошибок для этих дистрибутивов.

  • yum Используйте диспетчер пакетов, если вы используете систему Linux, которая не поддерживает dnf диспетчер пакетов.

Установка Azure CLI

Чтобы установить Azure CLI, выполните следующие действия.

  1. Импортируйте ключ репозитория Майкрософт. Для RHEL 10 и CentOS Stream 10,

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

    Для более низких версий используйте следующую команду:

     sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. Для RHEL 10 добавьте packages-microsoft-com-prod репозиторий:

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

    Для CentOS Stream 10 добавьте packages-microsoft-com-prod репозиторий:

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

    Для RHEL 9 или CentOS Stream 9 добавьте packages-microsoft-com-prod репозиторий:

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

    Для RHEL 8 добавьте packages-microsoft-com-prod репозиторий:

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

    Для RHEL 7 добавьте azure-cli репозиторий:

    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
    

    Осторожность

    CentOS 7 Конец жизни (EOL) был 30 июня 2024 года. Сведения о поддерживаемых средах Azure CLI см. в разделе Azure CLI жизненный цикл поддержки

  3. Выполните установку с помощью команды dnf install.

    sudo dnf install azure-cli
    

Установка конкретной версии

Сначала необходимо сконфигурировать azure-cli информацию о репозитории, как показано ранее. Доступные версии можно найти в заметках о выпуске Azure CLI.

  1. Можно получить список доступных версий с помощью команды:

    dnf list --showduplicates azure-cli
    
  2. Установка конкретной версии:

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

Обновление Azure CLI

Начиная с версии 2.11.0 Azure CLI предоставляет команду в средстве для обновления до последней версии.

az upgrade

Эта команда также по умолчанию обновляет все установленные расширения. Для получения дополнительных az upgrade параметров см. справочную страницу по командам. Для версий Azure CLI до 2.11.0 обновите, переустановив, как описано в Install Azure CLI.

Вы также можете обновить Azure CLI с помощью команды dnf update.

sudo dnf update azure-cli

Удаление Azure CLI

Если вы решите удалить Azure CLI, мы сожалеем, что вы решили это сделать. Перед удалением воспользуйтесь командой az feedback, чтобы сообщить нам, что можно улучшить или исправить. Наша цель заключается в том, чтобы сделать Azure CLI без ошибок и удобных для пользователей. Если вы нашли ошибку, мы будем признательны, если вы заведете проблему в GitHub.

  1. Удалите пакет из системы.

    sudo dnf remove azure-cli
    
  2. Если вы не планируете переустанавливать CLI, удалите сведения о репозитории.

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. Если вы не используете другие пакеты Майкрософт, удалите ключ подписывания.

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

Удаление данных

Если вы не планируете переустановить Azure CLI, удалите его данные.

rm -rf ~/.azure

Устранение неполадок

Ниже описаны некоторые распространенные проблемы при установке с помощью dnf. Если возникла проблема, не описанная здесь, создайте запрос на GitHub.

Установка в RHEL 7.6 или других системах без Python 3

Если вы сможете, обновите систему до версии с официальной поддержкой python 3.6+ пакета. В противном случае сначала необходимо установить пакет python3, а затем установить Azure CLI без зависимостей.

Следующая команда позволяет скачать и установить скрипт установки Azure CLI, собранный из исходного кода с python 3.6:

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

Кроме того, это можно сделать пошагово:

Во-первых, для работы Azure CLI необходим SSL 1.1+, и необходимо создать openssl 1.1 из исходного кода перед созданием 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

Затем выполните сборку Python 3 из источника:

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

Наконец, выполните шаги 1 и 2 инструкции install, чтобы добавить репозиторий Azure CLI. Затем можно скачать пакет и установить его без зависимости.

Замечание

Если плагин загрузки dnf ещё не установлен, вы столкнетесь с ошибкой command not found при выполнении следующего кода. Используйте dnf install 'dnf-command(download)' для установки плагина для загрузки dnf.

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

В качестве альтернативы можно также установить Python 3 с помощью репозитория another. Используйте этот метод, если вы настроили python3 , но по-прежнему получаете ошибку python3: command not found. Убедитесь, что он добавлен в ваш путь доступа.

scl enable rh-python36 bash

Прокси-сервер блокирует подключение

Если вы не можете подключиться к внешнему ресурсу из-за прокси-сервера, убедитесь, что вы правильно задали переменные HTTP_PROXY и HTTPS_PROXY в оболочке. Чтобы узнать, какие хосты и порты используются для этих прокси-серверов, необходимо обратиться к системному администратору.

Значения в этих переменных используются многими программами Linux и во время процесса установки. Чтобы задать эти значения, сделайте следующее:

# 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]

Это важно

Если вы находитесь за прокси-сервером, эти переменные оболочки должны быть установлены для подключения к службам Azure с помощью CLI. Если вы не используете обычную аутентификацию, рекомендуется экспортировать эти переменные в файл .bashrc. Всегда следуйте корпоративным политикам безопасности и учитывайте требования системного администратора.

Возможно, вы также захотите явно задать настройки dnf, чтобы всегда использовать этот прокси-сервер. Убедитесь, что следующие строки отображаются в разделе [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

Чтобы получить ключ подписи Майкрософт и пакет из нашего репозитория, прокси-сервер должен разрешить HTTPS-подключения к следующему адресу:

  • https://packages.microsoft.com

Не удается установить или запустить интерфейс командной строки на Windows Subsystem for Linux

Так как Windows Subsystem for Linux (WSL) — это уровень перевода системных вызовов на вершине платформы Windows, вы можете столкнуться с ошибкой при попытке установить или запустить Azure CLI. CLI полагается на некоторые функции, которые могут иметь баг в WSL. Если независимо от процедуры установки CLI вы получаете сообщение об ошибке, вероятнее всего, проблема связана с WSL, а не с процессом установки CLI.

Чтобы устранить проблемы с вашей установкой WSL и возможно их решить, выполните следующие действия:

  • При возможности выполните идентичный процесс установки на компьютере или виртуальной машине с Linux, чтобы проверить успешность установки. Если это так, скорее всего, проблема связана с WSL. Сведения о запуске виртуальной машины Linux в Azure см. в документации создания виртуальной машины Linux на портале Azure.
  • Убедитесь, что вы используете последнюю версию WSL. Чтобы получить последнюю версию, обновите установку Windows 10.
  • Проверьте наличие открытых вопросов с WSL, которые могут быть связаны с вашей проблемой. Часто есть предложения о том, как обойти проблему, или сведения о выпуске, в котором устранена проблема.
  • Если вы не нашли вашу проблему среди существующих проблем, сообщите о новой проблеме в WSL и включите как можно больше сведений.

Если у вас по-прежнему возникают проблемы с установкой или запуском в WSL, рассмотрите возможность установки интерфейса командной строки для Windows.

Перед тем как начать

  • Azure CLI 2.38.2 (выпущено 21 июня 2024 г.) — это последняя версия, поддерживаемая в SUSE Linux Enterprise Server (SLES) и OpenSUSE (Leap). Корпорация Майкрософт больше не предоставляет обновления или исправления ошибок для этих дистрибутивов.

  • SUSE поддерживает и поддерживает пакеты, предоставляемые репозиториями SUSE/OpenSUSE.

  • В Azure виртуальные машины SUSE и OpenSUSE на основе образов из Azure Marketplace уже содержат установленный Azure CLI.

Установка Azure CLI

Чтобы установить Azure CLI в SUSE/OpenSUSE, выберите один из следующих методов:

  1. Используйте пакет Enterprise, предоставленный SUSE в репозиториях SUSE /OpenSUSE.

  2. Используйте метод установки, описанный на вкладке "Установить скрипт (любой)".

  3. Установка из репозиториев Майкрософт

Установка из репозиториев SUSE или OpenSUSE

Пакет RPM Azure CLI зависит от пакета python3.

sudo zypper install -y azure-cli

Установка из репозиториев Майкрософт

Чтобы установить последнюю историческую версию Azure CLI с помощью репозиториев Майкрософт, выполните следующие действия.

(Этот пакет протестирован с помощью SLES 15 и OpenSUSE Leap 15.1)

  1. Установите curl:

    sudo zypper install -y curl
    
  2. Импортируйте ключ репозитория Майкрософт:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  3. Создайте сведения о локальном репозитории azure-cli:

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
    
  4. Обновите индекс пакета zypper и выполните установку:

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

    Введите 2, чтобы продолжить установку, игнорируя некоторые зависимости.

Установка конкретной версии

Сначала необходимо сконфигурировать azure-cli информацию о репозитории, как показано ранее. Доступные версии можно найти в заметках о выпуске Azure CLI.

  1. Просмотрите доступные версии с помощью этой команды:

    zypper search --details --match-exact azure-cli
    
  2. Установка конкретной версии:

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

Обновление Azure CLI

Начиная с версии 2.11.0 Azure CLI предоставляет команду в средстве для обновления до последней версии.

az upgrade

Эта команда также по умолчанию обновляет все установленные расширения. Для получения дополнительных az upgrade параметров см. справочную страницу по командам. Для версий Azure CLI до 2.11.0 обновите, переустановив, как описано в Install Azure CLI.

Вы также можете обновить пакет с помощью команды zypper update.

sudo zypper refresh
sudo zypper update azure-cli

Удаление Azure CLI

Если вы решите удалить Azure CLI, мы сожалеем, что вы решили это сделать. Перед удалением воспользуйтесь командой az feedback, чтобы сообщить нам, что можно улучшить или исправить. Наша цель заключается в том, чтобы сделать Azure CLI без ошибок и удобных для пользователей. Если вы нашли ошибку, мы будем признательны, если вы заведете проблему в GitHub.

  1. Удалите пакет из системы.

    sudo zypper remove -y azure-cli
    
  2. Если вы не планируете переустанавливать CLI, удалите сведения о репозитории.

    sudo zypper removerepo azure-cli
    
  3. Если вы не используете другие пакеты Майкрософт, удалите ключ подписывания (Майкрософт).

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

Удаление данных

Если вы не планируете переустановить Azure CLI, удалите его данные.

rm -rf ~/.azure

Устранение неполадок

Ниже описаны некоторые распространенные проблемы при установке с помощью zypper. Если возникла проблема, не описанная здесь, создайте запрос на GitHub.

Установка без Python 3

Это важно

Пакет RPM Azure CLI зависит от пакета python3. На вашей системе это может быть версия Python, которая предшествует требованию Python 3.6.x. Если это может повлиять на вас, найдите заменяющий пакет python3.

Помните, что Python 2 достигли конца жизни (EOL) 1 января 2020 года и больше не получат обновления. Azure CLI удалена поддержка Python 2.7 с версии 2.1.0. Более новые версии интерфейса командной строки могут работать неправильно с помощью Python 2.7.

Ошибка NotImplementedError в виртуальной машине OpenSUSE 15

Виртуальная машина OpenSUSE 15 имеет предварительно установленную Azure CLI с версией 2.0.45, которая устарела и имеет проблемы с az login. Удалите эту версию вместе со своими зависимостями перед выполнением инструкции Install, чтобы добавить последние Azure CLI:

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

Если вы обновили Azure CLI без удаления зависимостей версии 2.0.45, старые зависимости могут повлиять на последнюю версию Azure CLI. Необходимо добавить обратно старую версию, чтобы подключить ее к зависимостям, а затем удалить azure-cli вместе с этими зависимостями.

# 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

Установка в SLES 12 или других системах без Python 3.6

В SLES 12 версия пакета по умолчанию python3 — 3.4, и она не поддерживается Azure CLI. Вы можете сначала выполнить шаги 1–3 инструкции по установке, чтобы добавить репозиторий azure-cli. Затем выполните сборку более поздней версии python3 из источника. Наконец, можно скачать пакет Azure CLI и установить его без зависимостей.

Следующую команду можно использовать для установки или обновления Azure CLI на основе описанных выше действий. Скрипт устанавливает Python 3.8 в /usr/local/azcli и настраивает Azure CLI для его использования путем установки псевдонима az на PATH=/usr/local/azcli/bin:$PATH az. Вы также можете скачать скрипт и изменить его в соответствии с вашими потребностями. Например, можно изменить версию Python или установить расположение.

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

При первой установке обязательно выполните следующую команду, чтобы активировать псевдоним:

source ~/.bashrc

Прокси-сервер блокирует подключение

Если вы не можете подключиться к внешнему ресурсу из-за прокси-сервера, убедитесь, что вы правильно задали переменные HTTP_PROXY и HTTPS_PROXY в оболочке. Чтобы узнать, какие хосты и порты используются для этих прокси-серверов, необходимо обратиться к системному администратору.

Значения в этих переменных используются многими программами Linux и во время процесса установки. Чтобы задать эти значения, сделайте следующее:

# 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]

Это важно

Если вы находитесь за прокси-сервером, эти переменные оболочки должны быть установлены для подключения к службам Azure с помощью CLI. Если вы не используете обычную аутентификацию, рекомендуется экспортировать эти переменные в файл .bashrc. Всегда следуйте корпоративным политикам безопасности и учитывайте требования системного администратора.

Вы также можете явно настроить zypper (через yast2) для всегдаго использования этого прокси-сервера. Чтобы сделать это, выполните команду yast2 proxy как суперпользователь и заполните форму. Если в системе установлен диспетчер окон, можно также использовать панель Network Services > Proxy в YaST Control Center.

Дополнительные сведения о расширенной конфигурации см. в документации по конфигурации прокси-сервера OpenSUSE.

Чтобы получить ключ подписи Майкрософт и получить пакет из нашего репозитория, прокси-сервер должен разрешить подключения HTTPS к следующим адресам:

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

Не удается установить или запустить интерфейс командной строки на Windows Subsystem for Linux

Так как Windows Subsystem for Linux (WSL) — это уровень перевода системных вызовов на вершине платформы Windows, вы можете столкнуться с ошибкой при попытке установить или запустить Azure CLI. CLI полагается на некоторые функции, которые могут иметь баг в WSL. Если независимо от процедуры установки CLI вы получаете сообщение об ошибке, вероятнее всего, проблема связана с WSL, а не с процессом установки CLI.

Чтобы устранить проблемы с вашей установкой WSL и возможно их решить, выполните следующие действия:

  • При возможности выполните идентичный процесс установки на компьютере или виртуальной машине с Linux, чтобы проверить успешность установки. Если это так, скорее всего, проблема связана с WSL. Сведения о запуске виртуальной машины Linux в Azure см. в документации создания виртуальной машины Linux на портале Azure.
  • Убедитесь, что вы используете последнюю версию WSL. Чтобы получить последнюю версию, обновите установку Windows 10.
  • Проверьте наличие открытых вопросов с WSL, которые могут быть связаны с вашей проблемой. Часто есть предложения о том, как обойти проблему, или сведения о выпуске, в котором устранена проблема.
  • Если вы не нашли вашу проблему среди существующих проблем, сообщите о новой проблеме в WSL и включите как можно больше сведений.

Если у вас по-прежнему возникают проблемы с установкой или запуском в WSL, рассмотрите возможность установки интерфейса командной строки для Windows.

Проблема с сертификатом SSL

Если сертификат поврежден или устарел на компьютере, может появиться сообщение об ошибке, указывающее, что curl не удалось проверить легитимность сервера и поэтому не удалось установить безопасное подключение. Обновите сертификат, чтобы устранить проблему.

sudo zypper update-ca-certificates

Перед тем как начать

  • Диспетчер пакетов apt содержит пакеты x86_64 и ARM64 для Azure CLI, протестированных в следующих дистрибутивах.

    Распределение Версия
    Debian 11 (Буллси), 12 (Книжный червь)
    Убунту 22.04 (Джемми Медуза), 24.04 (Noble Numbat)

Установка Azure CLI

Существует два варианта установки Azure CLI в системе. Вы можете скачать скрипт установки, который запускает команды установки для вас или выполнить команды установки самостоятельно в пошаговом процессе. Здесь приведены оба метода:

Вариант 1. Установка с помощью одной команды

Самый простой способ установить Azure CLI — это скрипт, поддерживаемый командой Azure CLI. Этот скрипт выполняет все команды установки на одном шаге. Этот скрипт скачивается с помощью curl и передается непосредственно в bash для установки CLI.

Если вы хотите проверить содержимое скрипта перед выполнением, скачайте скрипт сначала с помощью curl и проверьте его в избранном текстовом редакторе.

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

Вариант 2. Пошаговые инструкции по установке

Если вы предпочитаете пошаговый процесс установки, выполните следующие действия, чтобы установить Azure CLI.

  1. Получение пакетов, необходимых для процесса установки:

    sudo apt-get update
    sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
    
  2. Скачайте и установите ключ подписывания (Майкрософт):

    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. Добавьте репозиторий программного обеспечения 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. Обновите сведения о репозитории и установите пакет azure-cli:

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

Установка конкретной версии

Настройте сведения о репозитории azure-cli , как показано ранее. Доступные версии можно найти в заметках о выпуске Azure CLI.

  1. Просмотр доступных версий Azure CLI.

    apt-cache policy azure-cli
    
  2. Установите определенную версию.

    # 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}
    

    Чтобы установить определенную версию без переменных, замените версию Azure CLI и название дистрибутива Linux:

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

Если вы получили сообщение об ошибке невозможно найти пакет azure-cli, azure-cli информация о репозитории не сконфигурирована. Выполните действия, описанные в варианте 2. Пошаговые инструкции по установке.

Если вы получили сообщение об ошибке "Версия x.xx.x-1~distributionName для azure-cli не найдена", используйте lsb_release -cs для поиска используемого дистрибутива.

Обновление Azure CLI

Начиная с версии 2.11.0 Azure CLI предоставляет команду в средстве для обновления до последней версии.

az upgrade

Эта команда также по умолчанию обновляет все установленные расширения. Для получения дополнительных az upgrade параметров см. справочную страницу по командам. Для версий Azure CLI до 2.11.0 обновите, переустановив, как описано в Install Azure CLI.

Вы также можете обновить пакет CLI с помощью команды apt-get upgrade. Эта команда обновляет все установленные пакеты в системе, которые не были изменены зависимостями.

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

Чтобы обновить только CLI, используйте apt-get install.

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

Удаление Azure CLI

Если вы решите удалить Azure CLI, мы сожалеем, что вы решили это сделать. Перед удалением воспользуйтесь командой az feedback, чтобы сообщить нам, что можно улучшить или исправить. Наша цель заключается в том, чтобы сделать Azure CLI без ошибок и удобных для пользователей. Если вы нашли ошибку, мы будем признательны, если вы заведете проблему в GitHub.

  1. Удалите с помощью apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Если вы не планируете переустановить интерфейс командной строки, удалите сведения о репозитории Azure CLI:

    sudo rm /etc/apt/sources.list.d/azure-cli.sources
    
  3. Если вы не используете другие пакеты от Корпорации Майкрософт, удалите ключ подписывания:

    sudo rm /etc/apt/keyrings/microsoft.gpg
    
  4. Удалите все ненужные пакеты:

    sudo apt autoremove
    

Удаление данных

Если вы не планируете переустановить Azure CLI, удалите его данные.

rm -rf ~/.azure

Устранение неполадок

Ниже описаны некоторые распространенные проблемы при установке с помощью apt. Если возникла проблема, не описанная здесь, создайте запрос на GitHub.

Пакет azure-cli поддерживает архитектуру ARM64 из CLI версии 2.46.0.

lsb_release не возвращает правильную базовую версию распределения

Некоторые дистрибутивы ubuntu или другие дистрибутивы, производные от Debian (например, Linux Mint), могут не возвращать правильное имя версии из lsb_release. Это значение используется при установке для определения устанавливаемого пакета. Если вы знаете кодовое имя версии Ubuntu или Debian, на основе которого создан ваш дистрибутив, можно задать AZ_REPO значение вручную при добавлении репозитория. В противном случае найдите информацию о том, как определить кодовое имя основного дистрибутива, и задайте для AZ_REPO правильное значение.

Для вашего дистрибутива отсутствует пакет

Иногда обновленный пакет Azure CLI недоступен сразу после выпуска версии дистрибутива. Azure CLI предназначена для обеспечения устойчивости к будущим версиям зависимостей и зависит от них как можно меньше. Если для вашего базового дистрибутива отсутствует пакет, попробуйте установить пакет для более ранней версии дистрибутива.

Чтобы попробовать пакет для более раннего распространения, задайте значение AZ_REPO вручную при добавлении репозитория. Для дистрибутивов Ubuntu используйте актуальный репозиторий jammy:

AZ_REPO="jammy"

Для дистрибутивов Debian используйте актуальный репозиторий bookworm:

AZ_REPO="bookworm"

Это важно

Более ранние версии дистрибутивов, чем Ubuntu Bionic и Debian Buster, не поддерживаются.

Elementary OS (EOS) не может установить Azure CLI

EOS не удается установить Azure CLI, так как lsb_release возвращает HERA, которое является именем версии EOS. Чтобы устранить проблему, нужно исправить файл /etc/apt/sources.list.d/azure-cli.sources и изменить Suites: hera на Suites: bionic.

Исходное содержимое файла:

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

Измененное содержимое файла:

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

Прокси-сервер блокирует подключение

Если вы не можете подключиться к внешнему ресурсу из-за прокси-сервера, убедитесь, что вы правильно задали переменные HTTP_PROXY и HTTPS_PROXY в оболочке. Чтобы узнать, какие хосты и порты используются для этих прокси-серверов, необходимо обратиться к системному администратору.

Значения в этих переменных используются многими программами Linux и во время процесса установки. Чтобы задать эти значения, сделайте следующее:

# 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]

Это важно

Если вы находитесь за прокси-сервером, эти переменные оболочки должны быть установлены для подключения к службам Azure с помощью CLI. Если вы не используете обычную аутентификацию, рекомендуется экспортировать эти переменные в файл .bashrc. Всегда следуйте корпоративным политикам безопасности и учитывайте требования системного администратора.

Возможно, вы также захотите явно задать настройки apt, чтобы всегда использовать этот прокси-сервер. Убедитесь, что следующие строки отображаются в файле конфигурации apt в /etc/apt/apt.conf.d/. Мы рекомендуем использовать существующий файл глобальной конфигурации или существующий файл конфигурации прокси-сервера (40proxies или 99local), но вам следует учитывать требования системного администратора.

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

Если ваш прокси-сервер не использует базовую проверку подлинности, удалите часть URI прокси-сервера [username]:[password]@. См. подробнее о конфигурации прокси-сервера в официальной документации по Ubuntu:

Чтобы получить ключ подписи Майкрософт и получить пакет из нашего репозитория, прокси-сервер должен разрешить HTTPS-подключения к следующему адресу:https://packages.microsoft.com.

Не удается установить или запустить интерфейс командной строки на Windows Subsystem for Linux

Так как Windows Subsystem for Linux (WSL) — это уровень перевода системных вызовов на вершине платформы Windows, вы можете столкнуться с ошибкой при попытке установить или запустить Azure CLI. CLI полагается на некоторые функции, которые могут иметь баг в WSL. Если независимо от процедуры установки CLI вы получаете сообщение об ошибке, вероятнее всего, проблема связана с WSL, а не с процессом установки CLI.

Чтобы устранить проблемы с вашей установкой WSL и возможно их решить, выполните следующие действия:

  • При возможности выполните идентичный процесс установки на компьютере или виртуальной машине с Linux, чтобы проверить успешность установки. Если это так, скорее всего, проблема связана с WSL. Сведения о запуске виртуальной машины Linux в Azure см. в документации создания виртуальной машины Linux на портале Azure.
  • Убедитесь, что вы используете последнюю версию WSL. Чтобы получить последнюю версию, обновите установку Windows 10.
  • Проверьте наличие открытых вопросов с WSL, которые могут быть связаны с вашей проблемой. Часто есть предложения о том, как обойти проблему, или сведения о выпуске, в котором устранена проблема.
  • Если вы не нашли вашу проблему среди существующих проблем, сообщите о новой проблеме в WSL и включите как можно больше сведений.

Если у вас по-прежнему возникают проблемы с установкой или запуском в WSL, рассмотрите возможность установки интерфейса командной строки для Windows.

Установка Azure CLI

RPMs выпускаются для Azure Linux через CBL-Mariner. Пакет azure-cli поддерживает архитектуру ARM64 из CLI версии 2.46.0.

Чтобы установить Azure CLI, выполните следующие действия.

  1. Установите официальный проверенный корпорацией Майкрософт набор доверенных корневых сертификатов:

    sudo tdnf install ca-certificates
    
  2. Установите Azure CLI:

    sudo tdnf install azure-cli
    

Установка конкретной версии

Доступные версии можно найти в заметках о выпуске Azure CLI.

Можно получить список доступных версий с помощью команды:

tdnf list azure-cli

Чтобы установить конкретную версию, выполните следующую команду:

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

Обновление Azure CLI

Обновите Azure CLI с помощью команды tdnf update:

sudo tdnf update azure-cli

Удаление Azure CLI

Если вы решите удалить Azure CLI, мы сожалеем, что вы решили это сделать. Перед удалением воспользуйтесь командой az feedback, чтобы сообщить нам, что можно улучшить или исправить. Наша цель заключается в том, чтобы сделать Azure CLI без ошибок и удобных для пользователей. Если вы нашли ошибку, мы будем признательны, если вы заведете проблему в GitHub.

Удалите пакет из системы:

sudo tdnf remove azure-cli

Удаление данных

Если вы не планируете переустановить Azure CLI, удалите его данные.

rm -rf ~/.azure

Дальнейшие шаги

Теперь, когда вы установили Azure CLI, ознакомьтесь со своими функциями и общими командами.