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

Если вы используете дистрибутив, включающий apt, например Ubuntu или Debian, доступен пакет Azure CLI x86_64.If you are running a distribution that comes with apt, such as Ubuntu or Debian, there's an x86_64 package available for the Azure CLI. Этот пакет протестирован и поддерживается для:This package has been tested with and is supported for:

  • Ubuntu Trusty, Xenial, Artful, Bionic и Disco.Ubuntu trusty, xenial, artful, bionic, and disco
  • Debian wheezy, jessie и stretchDebian wheezy, jessie, stretch, and buster

Текущая версия 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.

Примечание

Пакет для Azure CLI устанавливает собственный интерпретатор Python и не использует системный Python.The package for Azure CLI installs its own Python interpreter, and does not use the system Python.

УстановкаInstall

Мы предлагаем два способа установки Azure CLI с дистрибутивами, которые поддерживают apt: комплексный скрипт, который автоматически выполняет команды установки, и инструкции, которые вы сами можете выполнять поэтапно.We offer two ways to install the Azure CLI with distributions that support apt: As an all-in-one script that runs the install commands for you, and instructions that you can run as a step-by-step process on your own.

Установка с помощью одной командыInstall with one command

Мы предлагаем и поддерживаем скрипт, который выполняет все команды установки за один шаг.We offer and maintain a script which runs all of the installation commands in one step. Запустите его с помощью curl и передайте непосредственно в bash или скачайте скрипт в файл и проверьте его перед запуском.Run it by using curl and pipe directly to bash, or download the script to a file and inspect it before running.

Важно!

Этот скрипт протестирован только для Ubuntu 16.04+ и Debian 8+.This script is only verified for Ubuntu 16.04+ and Debian 8+. Он может не работать в других дистрибутивах.It may not work on other distributions. Если вы используете производный дистрибутив, например Linux Mint, следуйте инструкциям по установке вручную и выполните необходимые действия для устранения неполадок.If you're using a derived distribution such as Linux Mint, follow the manual install instructions and perform any necessary troubleshooting.

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

Инструкции по установке вручнуюManual install instructions

Если вы не хотите запускать скрипт как суперпользователь или если выполнение комплексного скрипта завершается сбоем, воспользуйтесь приведенными ниже инструкциями, чтобы установить Azure CLI.If you don't want to run a script as superuser or the all-in-one script fails, follow these steps to install the Azure CLI.

  1. Получение пакетов, необходимых для процесса установки:Get packages needed for the install process:

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

    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:Add the Azure CLI software repository:
    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:Update repository information and install the azure-cli package:

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

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

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

Команда lsb_release не возвращает правильную версию базового дистрибутиваlsb_release does not return the correct base distribution version

Некоторые производные от Ubuntu или Debian дистрибутивы, например Linux Mint, могут возвращать неправильную версию при использовании команды lsb_release.Some Ubuntu- or Debian-derived distributions such as Linux Mint may not return the correct version name from lsb_release. Это значение используется при установке для определения устанавливаемого пакета.This value is used in the install process to determine the package to install. Если вы знаете кодовое имя версии Ubuntu или Debian, на основе которой создан ваш дистрибутив, можно установить значение параметра AZ_REPO вручную при добавлении репозитория.If you know the code name of the Ubuntu or Debian version your distribution is derived from, you can set the AZ_REPO value manually when adding the repository. В противном случае найдите информацию о том, как определить кодовое имя основного дистрибутива, и задайте для AZ_REPO правильное значение.Otherwise, look up information for your distribution on how to determine the base distribution code name and set AZ_REPO to the correct value.

Для вашего дистрибутива отсутствует пакетNo package for your distribution

Иногда между выпуском дистрибутива и выпуском пакета Azure CLI для этого дистрибутива может пройти некоторое время.Sometimes it may be a while after a distribution is released before there's an Azure CLI package available for it. Azure CLI использует минимально возможный набор зависимостей и разработан таким образом, чтобы свести к минимуму вероятность нарушения работы при обновлении зависимостей.The Azure CLI designed to be resilient with regards to future versions of dependencies and rely on as few of them as possible. Если для вашего базового дистрибутива отсутствует пакет, попробуйте установить пакет для более ранней версии дистрибутива.If there's no package available for your base distribution, try a package for an earlier distribution.

Для этого вручную установите значение AZ_REPO при добавлении репозитория.To do this, set the value of AZ_REPO manually when adding the repository. Для дистрибутивов Ubuntu используйте репозиторий bionic, а для дистрибутивов Debian используйте репозиторий stretch.For Ubuntu distributions use the bionic repository, and for Debian distributions use stretch. Более ранние версии дистрибутивов, чем Ubuntu Trusty и Debian Wheezy, не поддерживаются.Distributions released before Ubuntu Trusty and Debian Wheezy are not supported.

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

В EOS не удалось установить Azure CLI, так как lsb_release возвращает HERA, то есть имя выпуска EOS.EOS fails to install the Azure cli because lsb_release returns HERA, which is the EOS release name. Чтобы устранить проблему, нужно исправить файл /etc/apt/sources.list.d/azure-cli.list и изменить hera main на bionic main.The solution is to fix the file /etc/apt/sources.list.d/azure-cli.list and change hera main to bionic main.

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

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

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

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

Прокси-сервер блокирует подключения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.

Вы также можете явным образом настроить apt, чтобы использовать этот прокси-сервер все время.You may also want to explicitly configure apt to use this proxy at all times. Убедитесь, что следующие строки отображаются в файле конфигурации apt в /etc/apt/apt.conf.d/.Make sure that the following lines appear in an apt configuration file in /etc/apt/apt.conf.d/. Мы рекомендуем использовать существующий файл глобальной конфигурации или существующий файл конфигурации прокси-сервера (40proxies или 99local), но вам следует учитывать требования системного администратора.We recommend using either your existing global configuration file, an existing proxy configuration file, 40proxies, or 99local, but follow your system administration requirements.

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

Если прокси-сервер не использует обычную аутентификацию, удалите часть [username]:[password]@ URI прокси-сервера.If your proxy does not use basic auth, remove the [username]:[password]@ portion of the proxy URI. См. подробнее о конфигурации прокси-сервера в официальной документации по Ubuntu:If you require more information for proxy configuration, see the official Ubuntu documentation:

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

Используйте apt-get upgrade, чтобы обновить пакет CLI.Use apt-get upgrade to update the CLI package.

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

Примечание

Эта команда позволяет обновить все установленные в системе пакеты, зависимости которых не были изменены.This command upgrades all of the installed packages on your system that have not had a dependency change. Чтобы обновить только CLI, используйте apt-get install.To upgrade the CLI only, use apt-get install.

sudo apt-get update && sudo apt-get install --only-upgrade -y 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. Выполите удаление с помощью команды apt-get remove:Uninstall with apt-get remove:

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

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Если вы не используете другие пакеты от корпорации Майкрософт, удалите ключ подписывания.If you use no other packages from Microsoft, remove the signing key:

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

    sudo apt autoremove
    

Next StepsNext Steps

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