Поделиться через


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

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

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

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

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

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

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

brew update && brew install azure-cli

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

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

Завершение не работает

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

Для Zsh добавьте следующие две строки в нижней части .zshrc файла, а затем сохраните и перезагрузите профиль Zsh.

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

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

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

brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10

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

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

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

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

Внимание

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

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

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

Обновить

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

Начиная с версии 2.11.0, Azure CLI предоставляет команду в средстве для обновления до последней версии.

az upgrade

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

Вы также можете обновить сведения о локальном репозитории 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. Просмотрите общие сведения о его возможностях и список распространенных команд.