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

2025-08-05

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

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

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

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

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

Можно установить Azure CLI в macOS, обновив сведения о репозитории brew, а затем выполнив команду 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 обновите, переустановив, как описано в статье "Установка 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 см. в соответствующей статье.

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

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

Начало работы с Azure CLI