Установка Azure CLI в macOSInstall Azure CLI on macOS

На платформе macOS Azure CLI можно установить с помощью диспетчера пакетов Homebrew.For the macOS platform, you can install the Azure CLI with homebrew package manager. Homebrew позволяет без труда поддерживать установку CLI в актуальном состоянии.Homebrew makes it easy to keep your installation of the CLI update to date. Пакет CLI протестирован с macOS 10.9 и более поздних версий.The CLI package has been tested on macOS versions 10.9 and later.

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

Установка с помощью HomebrewInstall with Homebrew

Homebrew — это самый простой способ управления установкой CLI.Homebrew is the easiest way to manage your CLI install. Это удобное средство установки, обновления и удаления,It provides convenient ways to install, update, and uninstall. Если у вас в системе нет диспетчера пакетов homebrew, установите его, прежде чем продолжить.If you don't have homebrew available on your system, install homebrew before continuing.

Можно установить CLI, обновив сведения о репозитории brew, а затем выполнив команду install:You can install the CLI by updating your brew repository information, and then running the install command:

brew update && brew install azure-cli

Важно!

Azure CLI имеет зависимость с пакетом Homebrew python3 и выполняет его установку.The Azure CLI has a dependency on the Homebrew python3 package, and will install it. Интерфейс Azure CLI гарантированно совместим с последней версией python3, опубликованной в Homebrew.The Azure CLI is guaranteed to be compatible with the latest version of python3 published on Homebrew.

Запустите Azure CLI с помощью команды az.You can then 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

Если у вас возникли проблемы при установке CLI с помощью Homebrew, воспользуйтесь представленным ниже описанием распространенных ошибок.If you encounter a problem when installing the CLI through Homebrew, here are some common errors. Если у вас возникла проблема, не описанная здесь, сообщите об этом на сайте GitHub.If you experience a problem not covered here, file an issue on github.

Сжатие не выполняется.Completion is not working

Формула Homebrew в Azure CLI устанавливает файл завершения с именем az в каталоге завершения, управляемом Homebrew (расположение по умолчанию — /usr/local/etc/bash_completion.d/).The Homebrew formula of Azure CLI installs a completion file named az in the Homebrew-managed completions directory (default location is /usr/local/etc/bash_completion.d/). Чтобы включить завершение, следуйте инструкциям по использованию Homebrew.To enable completion, please follow Homebrew's instructions here.

Не удается найти Python или установленные пакетыUnable to find Python or installed packages

Во время установки с помощью homebrew может наблюдаться несовпадение дополнительного номера версии или другая проблема.There may be a minor version mismatch or other issue during homebrew installation. CLI не использует виртуальное окружение Python и попытается обнаружить установленную версию Python.The CLI doesn't use a Python virtual environment, so it relies on finding the installed Python version. Возможное решение — установить зависимость python3 и повторно создать на нее ссылку из Homebrew.A possible fix is to install and relink the python3 dependency from Homebrew.

brew update && brew install python3 && brew upgrade python3
brew link --overwrite python3

Установлена версия CLI 1.xCLI version 1.x is installed

Если установлена старая версия, это может произойти из-за устаревания кэша homebrew.If an out-of-date version was installed, it could be because of a stale homebrew cache. Следуйте инструкциям по обновлению.Follow the update instructions.

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

Вы не сможете получать ресурсы из Homebrew, если неправильно настроите использование прокси-сервера.You may be unable to get resources from Homebrew unless you have correctly configured it to use your proxy. Выполните инструкции по настройке прокси-сервера Homebrew.Follow the Homebrew proxy configuration instructions.

Важно!

Если вы работаете за прокси-сервером, HTTP_PROXY и HTTPS_PROXY нужно задать для подключения к службам Azure с помощью CLI.If you are behind a proxy, HTTP_PROXY and HTTPS_PROXY 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.

Чтобы вы могли получать соответствующие ресурсы из Homebrew, ваш прокси-сервер должен разрешать HTTPS-подключения по следующим адресам:In order to get the bottle resources from Homebrew, your proxy needs to allow HTTPS connections to the following addresses:

  • https://formulae.brew.sh
  • https://homebrew.bintray.com

UpdateUpdate

CLI регулярно обновляется для исправления ошибок, а также реализации улучшений, новых возможностей и функции предварительного просмотра.The CLI is regularly updated with bug fixes, improvements, new features, and preview functionality. Новый выпуск выходит примерно раз в две недели.A new release is available roughly every two weeks. Обновите сведения о локальном репозитории, а затем — сам пакет azure-cli.Update your local repository information and then upgrade the azure-cli package.

brew update && brew upgrade 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.

Для удаления пакета azure-cli воспользуйтесь homebrew.Use homebrew to uninstall the azure-cli package.

brew uninstall azure-cli

Другие методы установкиOther installation methods

При невозможности использовать Homebrew для установки Azure CLI в своей среде можно воспользоваться инструкциями по ручной установке для Linux.If you can't use homebrew to install the Azure CLI in your environment, it's possible to use the manual instructions for Linux. Следует учесть, что этот процесс не является официально рекомендованным для macOS.Note that this process is not officially maintained to be compatible with macOS. Всегда предпочтительнее использовать менеджер пакетов, например Homebrew.Using a package manager such as Homebrew is always recommended. Используйте метод ручной установки только при отсутствии других вариантов.Only use the manual installation method if you have no other option available.

Инструкции по ручной установке Azure CLI в Linux см. в соответствующей статье.For the manual installation instructions, see Install Azure CLI on Linux manually.

Next StepsNext Steps

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