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