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

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

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

Обзор

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

Distribution Версия
Ubuntu 14.04 LTS (Trusty Tahir), 16.04 LTS (Xenial Xerus), 18.04 LTS (Bionic Beaver), 20.04 LTS (Focal Fossa), 20.10 (Groovy Gorilla)
Debian Debian 8 (Jessie), Debian 9 (Stretch), Debian 10 (Buster)

Предупреждение

Для 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.

Пакет deb azure-cli не поддерживает архитектуру ARM64.

Варианты установки

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

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

Команда 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 ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. Скачайте и установите ключ подписывания (Майкрософт):

    curl -sL https://packages.microsoft.com/keys/microsoft.asc |
        gpg --dearmor |
        sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
    
  3. Добавьте репозиторий программного обеспечения Azure CLI:
    AZ_REPO=$(lsb_release -cs)
    echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" |
        sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. Обновите сведения о репозитории и установите пакет azure-cli:

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

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

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

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

    apt-cache policy azure-cli
    
  2. Чтобы установить конкретную версию, выполните следующую команду:

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

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

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

Проблема с отсутствием модуля в 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 используйте репозиторий bionic, а для дистрибутивов Debian используйте репозиторий stretch. Более ранние версии дистрибутивов, чем Ubuntu Trusty и Debian Wheezy, не поддерживаются.

В Elementary OS (EOS) не удалось установить Azure CLI

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

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

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

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

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

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

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

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

Update

CLI предоставляет встроенную команду для обновления до последней версии:

az upgrade

Примечание

Команда az upgrade была добавлена в версии 2.11.0 и не будет работать с предыдущими версиями. Чтобы обновить старые версии, переустановите их, как описано в статье Установка Azure CLI.

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

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

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

    sudo apt autoremove
    

Обзор

Для дистрибутивов Linux, использующих dnf, например RHEL, Fedora или CentOS, доступен пакет Azure CLI. Этот пакет протестирован с RHEL 7.7 и 8, Fedora 24 и более поздних версий, а также CentOS 7 и 8.

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

Важно!

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

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

Примечание

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

Установка

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

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. Создайте сведения о локальном репозитории 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
    

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

Ниже описаны некоторые распространенные проблемы при установке с помощью 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 не установлен, при выполнении приведенного ниже кода произойдет ошибка "Команда не найдена". Установите подключаемый модуль скачивания dnf с помощью команды dnf install 'dnf-command(download)'.

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

В качестве альтернативы можно также установить Python 3, используя дополнительные репозитории. Таким образом, если вы установили python3, но у вас по-прежнему возникает ошибка python3: command not found при попытке запустить CLI, необходимо включить его в путь.

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

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

Update

CLI предоставляет встроенную команду для обновления до последней версии:

az upgrade

Примечание

Команда az upgrade была добавлена в версии 2.11.0 и не будет работать с предыдущими версиями. Чтобы обновить старые версии, переустановите их, как описано в статье Установка Azure CLI.

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

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

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

Обзор

Для дистрибутивов Linux, использующих zypper, например openSUSE или SLES, доступен пакет Azure CLI. Этот пакет протестирован с openSUSE Leap 15.1 и SLES 15.

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

Важно!

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

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

Установка

  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
    

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

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

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

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

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

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

sudo zypper update-ca-certificates

Update

CLI предоставляет встроенную команду для обновления до последней версии:

az upgrade

Примечание

Команда az upgrade была добавлена в версии 2.11.0 и не будет работать с предыдущими версиями. Чтобы обновить старые версии, переустановите их, как описано в статье Установка Azure CLI.

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

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

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

Обзор

Примечание

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

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

Важно!

Начиная с версии 2.1.0, в CLI прекращена поддержка Python 2.7. Новые версии больше не будут гарантированно работать при использовании Python 2.7.

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

Для установки и обновления CLI требуется повторный запуск установочного скрипта. Установите CLI, выполнив curl.

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

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

Диагностика

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

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

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

Удаление

Нам будет очень жаль, если вы решите удалить 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

Next Steps

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