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

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

  • Статья

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

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

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

  • Azure CLI 2.38.2 (выпущено 21 июня 2024 г.) — это последняя версия, поддерживаемая в 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 добавьте 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 обновите, переустановив, как описано в статье "Установка 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, см. документацию по созданию виртуальной машины Linux в портале Azure.
  • Убедитесь, что вы используете последнюю версию WSL. Чтобы получить последнюю версию, обновите ОС Windows 10 на своем компьютере.
  • Проверьте наличие открытых вопросов с WSL, которые могут быть связаны с вашей проблемой. Часто есть предложения о том, как обойти проблему, или сведения о выпуске, в котором устранена проблема.
  • Если вы не смогли найти свой случай в существующих сообщениях о проблемах, сообщите о проблеме с WSL и включите в сообщение как можно больше сведений.

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

Перед началом

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

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

  • В виртуальных машинах SUSE и OpenSUSE на платформе Azure, основанных на образах из 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 использовать его, задав псевдоним 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

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

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

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

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

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

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

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

sudo zypper update-ca-certificates

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

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

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

  • Для 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. Дополнительные сведения смотрите в статье об управлении пакетами Ubuntu или на Ask 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 |
  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 обновите, переустановив, как описано в статье "Установка 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. Сначала удалите его, выполнив , а затем следуйте указаниям выше , чтобы установить последний пакет .

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.

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

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

Устранение неполадок с вашей установкой WSL и возможное решение проблем:

  • При возможности выполните идентичный процесс установки на компьютере или виртуальной машине с Linux, чтобы проверить успешность установки. Если это так, скорее всего, проблема связана с WSL. Чтобы запустить виртуальную машину Linux в Azure, ознакомьтесь с документацией по созданию виртуальной машины Linux в портале Azure.
  • Убедитесь, что вы используете последнюю версию 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. Проверьте, есть ли пакет для вашего дистрибутива перед установкой вручную.

Для скрипта установки Azure CLI требуется следующее программное обеспечение:

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

Внимание

Скрипт установки работает только на Python 3.8.x, 3.9.x или 3.10.x. Этот скрипт установки не работает в версиях Python 3.11.x или более поздних версий.

Для установки и обновления 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, чтобы начать использование Linux VM.
  • Убедитесь, что вы используете последнюю версию WSL. Чтобы получить последнюю версию, обновите ОС Windows 10 на своем компьютере.
  • Проверьте наличие открытых вопросов с WSL, которые могут помочь решить вашу проблему. Часто есть предложения о том, как обойти проблему, или сведения о выпуске, в котором устранена проблема.
  • Если для вашей проблемы нет существующих сообщений, создайте новое сообщение о проблеме с WSL и постарайтесь включить максимум информации.

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

Следующие шаги

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

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