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

  • Статья

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

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

Подготовка к работе

  • Azure CLI 2.38.1 (выпущена 01 сентября 2023 г.) — это последняя версия, поддерживаемая в RHEL 7 и Centos 7, и будет продолжать получать исправления безопасности до конца жизни операционных систем. Корпорация Майкрософт не предоставляет другие обновления или исправления ошибок для этих дистрибутивов.

  • Корпорация Майкрософт продолжает разрабатывать и поддерживать Azure CLI и скрипт установки Linux.

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

Установите Azure CLI

Для установки Azure CLI выполните следующие действия:

  1. Импортируйте ключ репозитория Майкрософт.

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

  2. Для 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 или CentOS Stream 8 добавьте репозиторий packages-microsoft-com-prod:

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

    Для RHEL 7 или CentOS 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

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

Не удается установить или запустить CLI в подсистеме Windows для Linux

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

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

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

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

Подготовка к работе

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

  • Корпорация Майкрософт продолжает разрабатывать и поддерживать Azure CLI и скрипт установки Linux. 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 в любой версии Linux с помощью параметра "Установить скрипт ".

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

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

Чтобы установить последнюю историческую версию 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 обновите, переустановив, как описано в статье "Установка 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, чем требуемая версия 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. Удалите эту версию вместе со своими зависимостями перед выполнением инструкции установки , чтобы добавить последнюю версию 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 его использовать, задав псевдоним azPATH=/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

Не удается установить или запустить CLI в подсистеме Windows для Linux

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

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

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

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

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

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

sudo zypper update-ca-certificates

Подготовка к работе

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

    Распределение Версия
    Ubuntu 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish)
    Debian 10 (Бюстер), 11 (Буллси), 12 (Книжный червь)

  • Для Ubuntu 20.04 (Focal Fossa) и 20.10 (Groovy Gorilla) доступен пакет azure-cli с версией 2.0.81, предоставляемый репозиторием universe. Этот пакет устарел и не рекомендуется к использованию. Если этот пакет установлен, удалите его, прежде чем продолжать работу, выполнив команду sudo apt remove azure-cli -y && sudo apt autoremove -y. Дополнительные сведения см apt remove. в статье об управлении пакетами Ubuntu или запросе ubuntu.

Установите 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 |
  sudo gpg --dearmor -o /etc/apt/keyrings/microsoft.gpg
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 обновите, переустановив, как описано в статье "Установка 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. Если вы не планируете переустанавливать CLI, удалите сведения о репозитории 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.

Проблема с отсутствием модуля в Ubuntu 20.04 (Focal)/WSL

Если вы установили azure-cli в выпуске Focal, не добавив репозиторий программного обеспечения Azure CLI, как предписывает шаг 3 инструкций по установке вручную, или с помощью нашего скрипта, могут возникнуть проблемы, например с отсутствием модуля с именем decorator или antlr4, так как установленный вами пакет является устаревшим пакетом azure-cli 2.0.81 из репозитория focal/universe. Сначала удалите его sudo apt remove azure-cli -y && sudo apt autoremove -y, выполнив указанные выше инструкции , чтобы установить последний azure-cli пакет.

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]";
}

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

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

Не удается установить или запустить CLI в подсистеме Windows для Linux

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

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

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

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

Установите Azure CLI

RPM выпускаются для 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

Подготовка к работе

Настоятельно рекомендуется устанавливать CLI с помощью диспетчера пакетов. Диспетчер пакетов гарантирует, что вы получите последние обновления, и обеспечит стабильность компонентов CLI. Проверьте и проверьте, есть ли пакет для дистрибутива перед установкой вручную.

Для использования CLI требуется следующее ПО:

Установка или обновление Azure CLI

Для установки и обновления Azure CLI требуется повторно запустить скрипт установки.

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

Скрипт также можно скачать и выполнить на локальном компьютере. Чтобы изменения вступили в силу, может потребоваться перезапустить оболочку.

Удаление Azure CLI

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

Удалите CLI, удалив файлы непосредственно из расположения, выбранного при установке. Расположение установки по умолчанию — это домашний каталог пользователя ($HOME).

  1. Удалите установленные файлы CLI.

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

  2. Измените файл $HOME/.bash_profile, чтобы удалить следующую строку:

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

  3. При использовании bash или zsh перезагрузите кэш команд в оболочке.

    hash -r

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

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

rm -rf ~/.azure

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

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

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

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

Ошибка "Объект перемещен" при выполнении команды curl

Если при выполнении команды curl появляется сообщение об ошибке относительно параметра -L или сообщение об ошибке "Объект перемещен", попробуйте использовать полный URL-адрес вместо URL-адреса перенаправления aka.ms:

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

Команда az не найдена

Если вы не можете выполнить команду после установки bash или zshпопробуйте очистить кэш хэша команд оболочки и проверка, если проблема устранена.

hash -r

Кроме того, проблема может возникнуть, если вы не перезапустили оболочку после установки. Убедитесь, что команда az добавлена в переменную $PATH. Расположение команды az:

 <install path>/bin

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

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

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

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Конечные точки, используемые диспетчером пакетов дистрибутива (при его наличии) для основных пакетов

Не удается установить или запустить CLI в подсистеме Windows для Linux

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

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

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

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

Next Steps

Теперь вы можете пользоваться Azure CLI. Просмотрите общие сведения о его возможностях и список распространенных команд.

Начало работы с Azure CLI