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

Интерфейс командной строки (CLI) Azure позволяет выполнять команды через терминал с использованием интерактивных запросов командной строки или скрипта. Azure CLI можно установить локально на компьютерах под управлением macOS. Azure CLI в macOS позволяет выполнять различные команды через терминал с использованием интерактивных запросов командной строки или скрипта.

На платформе macOS Azure CLI можно установить с помощью диспетчера пакетов Homebrew. Homebrew позволяет без труда поддерживать установку CLI в актуальном состоянии. Пакет CLI протестирован с macOS 10.9 и более поздних версий.

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

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

Homebrew — это самый простой способ управления установкой CLI. Это удобное средство установки, обновления и удаления, Если у вас в системе нет диспетчера пакетов homebrew, установите его, прежде чем продолжить.

Можно установить Azure CLI в macOS, обновив сведения о репозитории brew, а затем выполнив команду install:

brew update && brew install azure-cli

Важно!

Azure CLI имеет зависимость с пакетом Homebrew python3 и выполняет его установку. Интерфейс Azure CLI гарантированно совместим с последней версией python3, опубликованной в Homebrew.

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

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

Сжатие не выполняется.

Формула Homebrew в Azure CLI устанавливает файл завершения с именем az в каталоге завершения, управляемом Homebrew (расположение по умолчанию — /usr/local/etc/bash_completion.d/). Чтобы включить завершение, следуйте инструкциям по использованию Homebrew.

Не удается найти Python или установленные пакеты

Во время установки с помощью homebrew может наблюдаться несовпадение дополнительного номера версии или другая проблема. CLI не использует виртуальное окружение Python и попытается обнаружить установленную версию Python. Возможное решение — установить зависимость python3 и повторно создать на нее ссылку из Homebrew.

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

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

Если установлена старая версия, это может произойти из-за устаревания кэша homebrew. Следуйте инструкциям по обновлению.

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

Вы не сможете получать ресурсы из Homebrew, если неправильно настроите использование прокси-сервера. Выполните инструкции по настройке прокси-сервера Homebrew.

Важно!

Если вы работаете за прокси-сервером, HTTP_PROXY и HTTPS_PROXY нужно задать для подключения к службам Azure с помощью CLI. Если вы не используете обычную аутентификацию, рекомендуется экспортировать эти переменные в файл .bashrc. Всегда следуйте корпоративным политикам безопасности и учитывайте требования системного администратора.

Чтобы вы могли получать соответствующие ресурсы из Homebrew, ваш прокси-сервер должен разрешать HTTPS-подключения по следующим адресам:

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

Update

CLI регулярно обновляется для исправления ошибок, а также реализации улучшений, новых возможностей и функции предварительного просмотра. Новый выпуск выходит примерно раз в три недели.

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

az upgrade

Примечание

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

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

Вы также можете обновить сведения о локальном репозитории Homebrew, а затем — сам пакет azure-cli.

brew update && brew upgrade azure-cli

Удаление

Нам будет очень жаль, если вы решите удалить Azure CLI. Перед удалением воспользуйтесь командой az feedback, чтобы сообщить нам, что можно улучшить или исправить. Наша цель — исправить все ошибки Azure CLI и сделать его удобным для пользователей. Если вы нашли ошибку, мы будем признательны, если вы сообщите об этом на сайте GitHub.

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

brew uninstall azure-cli

Удаление данных

Если вы не планируете переустанавливать Azure CLI, удалите данные этого решения.

rm -rf ~/.azure

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

При невозможности использовать Homebrew для установки Azure CLI в своей среде можно воспользоваться инструкциями по ручной установке для Linux. Следует учесть, что этот процесс не является официально рекомендованным для macOS. Всегда предпочтительнее использовать менеджер пакетов, например Homebrew. Используйте метод ручной установки только при отсутствии других вариантов.

Инструкции по ручной установке Azure CLI в Linux см. в соответствующей статье.

Next Steps

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