Установка Azure CLI с помощью yumInstall Azure CLI with yum

Для дистрибутивов Linux, использующих yum, например RHEL, Fedora или CentOS, доступен пакет Azure CLI.For Linux distributions with yum such as RHEL, Fedora, or CentOS, there's a package for the Azure CLI. Этот пакет протестирован с RHEL 7.7 и 8, Fedora 24 и более поздних версий, а также CentOS 7 и 8.This package has been tested with RHEL 7.7, RHEL 8, Fedora 24 and higher, CentOS 7 and CentOS 8.

Текущая версия Azure CLI — 2.8.0.The current version of the Azure CLI is 2.8.0. Сведения о последнем выпуске см. в заметках о выпуске.For information about the latest release, see the release notes. Чтобы узнать, какая версия установлена и нужно ли ее обновить, выполните команду az --version.To find your installed version and see if you need to update, run az --version.

Важно!

Пакет RPM Azure CLI зависит от пакета python3.The RPM package of the Azure CLI depends on the python3 package. В вашей системе может быть установлена более ранняя версия Python, чем требуемая версия 3.6.x.On your system, this may be a Python version which predates the requirement of Python 3.6.x. Если это может повлиять на вас, найдите заменяющий пакет python3.If this affects you, find a replacement python3 package.

Помните, что с 1 января 2020 г. поддержка Python 2 прекращена, и соответствующие обновления выпускаться больше не будут.Be aware that Python 2 has reached the end of life on January 1, 2020, and will no longer receive updates. Начиная с версии 2.1.0, в Azure CLI прекращена поддержка Python 2.7.Azure CLI has dropped support for Python 2.7 since version 2.1.0. Новые версии больше не будут гарантированно работать при использовании Python 2.7.New versions no longer guarantee to run with Python 2.7 correctly.

УстановкаInstall

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

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

    sudo sh -c '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" > /etc/yum.repos.d/azure-cli.repo'
    
  3. Выполните установку с помощью команды yum install.Install with the yum install command.

    sudo yum install azure-cli
    

Обновите Azure CLI с помощью команды az.Run the Azure CLI with the az command. Чтобы войти, используйте команду az login.To sign in, use az login command.

  1. Выполните команду login.Run the login command.

    az login
    

    Если в CLI можно запустить браузер по умолчанию, откроется браузер со страницей входа.If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    Если нет, самостоятельно откройте в браузере страницу https://aka.ms/devicelogin и введите код авторизации, отображаемый в терминале.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. Выполните вход в браузере с помощью учетных данных.Sign in with your account credentials in the browser.

Дополнительные сведения о различных методах проверки подлинности см. в статье Вход с помощью Azure CLI.To learn more about different authentication methods, see Sign in with Azure CLI.

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

Ниже описаны некоторые распространенные проблемы при установке с помощью yum.Here are some common problems seen when installing with yum. Если у вас возникла проблема, не описанная здесь, сообщите об этом на сайте GitHub.If you experience a problem not covered here, file an issue on github.

Установка в RHEL 7.6 или других системах без Python 3Install on RHEL 7.6 or other systems without Python 3

По возможности обновите систему до версии с официальной поддержкой пакета python3.If you can, please upgrade your system to a version with official support for python3 package. В противном случае необходимо сначала установить пакет python3, а также выполнить сборку из источника или выполнить установку из определенного дополнительного репозитория.Otherwise, you need to first install a python3 package, either build from source or install through some additional repo. Затем можно скачать пакет и установить его без зависимости.Then you can download the package and install it without dependency.

$ sudo yum install yum-utils
$ sudo yumdownloader azure-cli
$ sudo rpm -ivh --nodeps azure-cli-*.rpm

Если вы установили Python 3, но у вас по-прежнему возникает ошибка python3: command not found при попытке запустить CLI, необходимо добавить путь в переменную среды.If you have setup python3 but are still getting an error python3: command not found when trying to run the cli, you need to add it to your path.

$ scl enable rh-python36 bash

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

Если вы не можете подключиться к внешнему ресурсу из-за прокси-сервера, убедитесь, что вы правильно задали переменные HTTP_PROXY и HTTPS_PROXY в оболочке.If you're unable to connect to an external resource due to a proxy, make sure that you've correctly set the HTTP_PROXY and HTTPS_PROXY variables in your shell. Обратитесь к системному администратору, чтобы узнать, какие узлы и порты использовать для этих прокси-серверов.You will need to contact your system administrator to know what host(s) and port(s) to use for these proxies.

Эти значения учитываются многими программами Linux, включая те, которые используются в процессе установки.These values are respected by many Linux programs, including those which are used in the install process. Чтобы задать эти значения, сделайте следующее:To set these values:

# 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.If you are behind a proxy, these shell variables must be set to connect to Azure services with the CLI. Если вы не используете обычную аутентификацию, рекомендуется экспортировать эти переменные в файл .bashrc.If you are not using basic auth, it's recommended to export these variables in your .bashrc file. Всегда следуйте корпоративным политикам безопасности и учитывайте требования системного администратора.Always follow your business' security policies and the requirements of your system administrator.

Вы также можете явным образом настроить yum, чтобы использовать этот прокси-сервер все время.You may also want to explicitly configure yum to use this proxy at all times. Убедитесь, что следующие строки отображаются в разделе [main] в /etc/yum.conf:Make sure that the following lines appear under the [main] section of /etc/yum.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-подключения по следующему адресу:In order to get the Microsoft signing key and get the package from our repository, your proxy needs to allow HTTPS connections to the following address:

  • https://packages.microsoft.com

Не удается установить или запустить CLI в подсистеме Windows для LinuxCLI fails to install or run on Windows Subsystem for Linux

Подсистема Windows для Linux (WSL) — это уровень преобразования системных вызовов поверх платформы Windows, поэтому при попытке установить или запустить Azure CLI вы можете получить сообщение об ошибке.Since Windows Subsystem for Linux (WSL) is a system call translation layer on top of the Windows platform, you might experience an error when trying to install or run the Azure CLI. CLI использует набор функций, которые в WSL могут быть реализованы с ошибками.The CLI relies on some features that may have a bug in WSL. Если независимо от процедуры установки CLI вы получаете сообщение об ошибке, вероятнее всего, проблема связана с WSL, а не с процессом установки CLI.If you experience an error no matter how you install the CLI, there's a good chance it's an issue with WSL and not with the CLI install process.

Чтобы найти причину проблем с установкой в WSL и попытаться устранить ее, выполните следующие действия:To troubleshoot your WSL installation and possibly resolve issues:

  • При возможности выполните идентичный процесс установки на компьютере или виртуальной машине с Linux, чтобы проверить успешность установки.If you can, run an identical install process on a Linux machine or VM to see if it succeeds. Если установка прошла успешно, почти наверняка, проблема связана с WSL.If it does, your issue is almost certainly related to WSL. Чтобы запустить виртуальную машину в Azure, см. документацию по созданию виртуальной машины Linux на портале Azure.To start a Linux VM in Azure, see the create a Linux VM in the Azure Portal documentation.
  • Убедитесь, что вы используете последнюю версию WSL.Make sure that you're running the latest version of WSL. Чтобы получить последнюю версию, обновите ОС Windows 10 на своем компьютере.To get the latest version, update your Windows 10 installation.
  • Проверьте отправленные сообщения о проблемах с WSL, которые могут иметь отношение к вашему случаю.Check for any open issues with WSL which might address your problem. Часто в них можно найти предложения относительно того, как обойти проблему, или сведения о выпуске, в котором проблема будет исправлена.Often there will be suggestions on how to work around the problem, or information about a release where the issue will be fixed.
  • Если вы не смогли найти свой случай в существующих сообщениях о проблемах, сообщите о проблеме с WSL и включите в сообщение как можно больше сведений.If there are no existing issues for your problem, file a new issue with WSL and make sure that you include as much information as possible.

Если у вас по-прежнему наблюдаются проблемы при установке или запуске в WSL, рассмотрите возможность установки CLI для Windows.If you continue to have issues installing or running on WSL, consider installing the CLI for Windows.

UpdateUpdate

Обновите Azure CLI, воспользовавшись командой yum update.Update the Azure CLI with the yum update command.

sudo yum update azure-cli

УдалениеUninstall

Нам будет очень жаль, если вы решите удалить Azure CLI.If you decide to uninstall the Azure CLI, we're sorry to see you go. Перед удалением воспользуйтесь командой az feedback, чтобы сообщить нам, что можно улучшить или исправить.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. Наша цель — исправить все ошибки Azure CLI и сделать его удобным для пользователей.Our goal is to make the Azure CLI bug-free and user-friendly. Если вы нашли ошибку, мы будем признательны, если вы сообщите об этом на сайте GitHub.If you found a bug, we'd appreciate it if you file a GitHub issue.

  1. Удалите пакет из системы.Remove the package from your system.

    sudo yum remove azure-cli
    
  2. Если вы не планируете переустанавливать CLI, удалите сведения о репозитории.If you don't plan to reinstall the CLI, remove the repository information.

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. Если вы не используете другие пакеты Майкрософт, удалите ключ подписывания.If you don't use any other Microsoft packages, remove the signing key.

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

Next StepsNext Steps

Теперь вы можете пользоваться Azure CLI. Просмотрите общие сведения о его возможностях и список распространенных команд.Now that you've installed the Azure CLI, take a short tour of its features and common commands.