Управление средствами разработки Azure с помощьюazd tool

Интерфейс командной строки разработчика Azure включаетazd встроенную azd tool группу команд для обнаружения, установки, обновления и проверки состояния распространенных средств, используемых для создания и отправки приложений Azure. Он предоставляет единообразную оболочку для базовых менеджеров пакетов на каждой платформе (например, winget, brew, apt, npm и CLI code VS Code) за единообразным набором подкоманд и поддерживает как интерактивное использование, так и автоматизацию.

Типичные сценарии использования для azd tool включают:

  • Установка всех рекомендуемых средств разработки Azure на новом компьютере с помощью одной команды.
  • Стандартизация среды разработки в команде или наборе агентов CI.
  • Аудит того, какие средства Azure (и какие версии) устанавливаются на определенном компьютере.
  • Проверка и применение обновлений к установленным средствам.
  • Настройка инструмента для написания сценариев в пайплайнах с использованием неинтерактивных флагов и вывода в формате JSON.

Встроенные инструменты

Встроенный реестр включает следующие средства. Используйте столбцы категории и приоритета, чтобы определить, какие средства применяются к заданному рабочему процессу.

Id Имя Category Priority Типичная стратегия установки
az-cli Azure CLI cli Рекомендуется winget / brew / apt
github-copilot-cli GitHub Copilot CLI cli Рекомендуется winget / brew / npm
vscode-azure-tools Инструменты Azure (VS Code) extension Рекомендуется code Интерфейс командной строки (CLI)
vscode-bicep Bicep (VS Code) extension Рекомендуется code Интерфейс командной строки (CLI)
vscode-github-copilot GitHub Copilot (VS Code) extension Optional code Интерфейс командной строки (CLI)
azure-mcp-server Сервер Azure MCP server Optional npm
azd-ai-extensions azd Расширения ИИ library Optional azd extension

Конкретная стратегия установки зависит от операционной системы и доступных на компьютере диспетчеров пакетов.

Note

Для расширений VS Code требуется, чтобы интерфейс командной строки code был доступен на PATH. Если code недоступен, инструменты отображаются как неустановленные, и их нельзя установить через azd tool.

Общие сведения о командах

Группа команд azd tool содержит следующие подкоманды.

командование Описание
azd tool Запускает интерактивный поток, показывающий установленные и доступные средства и запрашивает установку средств на одном шаге.
azd tool list Выводит список всех зарегистрированных средств, включая состояние установки, версию, категорию и приоритет.
azd tool show <id> Отображает подробные сведения для конкретного средства, включая стратегии установки для каждой платформы и веб-сайт проекта.
azd tool check Проверяет установленные средства на наличие доступных обновлений.
azd tool install [ids...] Устанавливает один или несколько инструментов с помощью id.
azd tool upgrade [ids...] Обновляет один или несколько установленных средств.

Все команды поддерживают --output json для вывода в машиночитаемом формате, подходящего для сценариев и конвейерной обработки.

Общие флаги

Доступны следующие флаги install и upgrade:

  • --all: устанавливает или обновляет каждый подходящий инструмент. Для install эта команда включает все рекомендуемые инструменты. Для команды upgrade отображаются все установленные инструменты, для которых доступны обновления.
  • --dry-run: показывает, какие действия azd выполнил бы без внесения каких-либо изменений.

Следующие параметры управляют поведением запроса:

  • --no-prompt: отключает интерактивные запросы. Полезно в сценариях.
  • AZD_NON_INTERACTIVE=true: переменная среды эквивалентна --no-prompt.
  • AZD_SKIP_FIRST_RUN=true: отключает запрос на проверку инструмента при первом запуске.

Пример использования: начальная загрузка компьютера разработки

Чтобы настроить полный набор рекомендуемых средств разработки Azure на новом компьютере, выполните следующую команду:

azd tool install --all

Эта команда устанавливает все средства, помеченные как recommended в реестре, с помощью соответствующего диспетчера пакетов для текущей платформы. Чтобы предварительно просмотреть действия установки без внесения изменений, добавьте --dry-run:

azd tool install --all --dry-run

Чтобы сохранить установленные средства в актуальном состоянии, выполните следующие команды:

azd tool check
azd tool upgrade --all

Список установленных и доступных средств

Выполните команду azd tool list , чтобы отобразить все зарегистрированные средства, состояние установки и ее установленную версию:

$ azd tool list

  Id                     Name                      Category    Priority      Status          Version
  ─────────────────────  ────────────────────────  ──────────  ────────────  ──────────────  ────────
  az-cli                 Azure CLI                 cli         recommended   Installed       2.67.0
  github-copilot-cli     GitHub Copilot CLI        cli         recommended   Not Installed
  vscode-azure-tools     Azure Tools (VS Code)     extension   recommended   Installed       0.9.0
  vscode-bicep           Bicep (VS Code)           extension   recommended   Installed       0.30.0
  vscode-github-copilot  GitHub Copilot (VS Code)  extension   optional      Not Installed
  azure-mcp-server       Azure MCP Server          server      optional      Not Installed
  azd-ai-extensions      azd AI Extensions         library     optional      Not Installed

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

azd tool list --output json

Отображение сведений о средстве

Запустите azd tool show <id>, чтобы просмотреть сведения о конкретном инструменте, включая стратегии установки, применимые к каждой поддерживаемой платформе, а также веб-сайт проекта:

azd tool show az-cli

Установка одного или нескольких средств

Передайте одно или несколько значений параметра tool id, чтобы установить конкретные инструменты:

azd tool install az-cli vscode-bicep

Чтобы установить каждое рекомендуемое средство, используйте --all:

azd tool install --all

Чтобы предварительно просмотреть команды установки без их запуска, добавьте --dry-run:

azd tool install az-cli --dry-run

При выполнении azd tool без подкоманда запускается интерактивный поток, который отображает установленные средства, позволяет выбирать дополнительные средства и устанавливать их на одном шаге.

Проверка обновлений

Запустите azd tool check, чтобы проверить установленные инструменты на наличие доступных обновлений:

azd tool check

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

Средства обновления

Обновите определённые инструменты, передав их значения id:

azd tool upgrade az-cli github-copilot-cli

Обновите все, что имеет доступное обновление:

azd tool upgrade --all

Просмотрите план обновления, не применяя его:

azd tool upgrade --all --dry-run

Интерфейс при первом запуске

При первом запуске команды рабочего процесса, например azd init, azd up или azd deploy, azd выполняет однократную проверку инструментов и предлагает проверить или установить рекомендуемые инструменты.

Используйте любой из следующих параметров, чтобы пропустить или отключить запрос первого запуска:

  • Передайте --no-prompt в команде workflow.
  • Задайте переменную AZD_SKIP_FIRST_RUN=trueсреды.
  • Запуск в обнаруженной CI-среде. azd автоматически пропускает запрос, если задано значение CI, TF_BUILD или GITHUB_ACTIONS.

CI и неинтерактивные сценарии

Группа azd tool команд поддерживает конвейеры и скрипты с помощью следующих параметров:

  • Используйте позиционные id аргументы с install и upgrade, чтобы избежать интерактивного выбора.
  • Добавьте --no-prompt или установите AZD_NON_INTERACTIVE=true, чтобы отключить запросы.
  • Используйте --output json для получения структурированных результатов на последующих этапах.
  • Используется автоматическое обнаружение CI, которое подавляет уведомления о первом запуске и фоновом обновлении.

В следующем примере Azure CLI и расширение Bicep устанавливаются на одном из шагов конвейера:

azd tool install az-cli vscode-bicep --no-prompt --output json

Связанный контент

  • Last updated on