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

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

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

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

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

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

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

brew update && brew install azure-cli

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

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

установлен Azure CLI версии 1.x

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

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

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

Это важно

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

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

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

Обновление

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

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

az upgrade

Эта команда также по умолчанию обновляет все установленные расширения. Для получения дополнительных az upgrade параметров см. справочную страницу по командам. Для версий Azure CLI до 2.11.0 обновите, переустановив, как описано в Install 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. Используйте метод ручной установки только при отсутствии других вариантов.

Инструкции по установке вручную см. в разделе Install Azure CLI в Linux вручную.

Дальнейшие шаги

Теперь, когда вы установили Azure CLI на macOS, ознакомьтесь со своими функциями и общими командами.

Начните работу с Azure CLI