Управление средствами разработки 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	Рекомендуется	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...]	Обновляет один или несколько установленных средств.
azd tool uninstall [ids...]	Удаляет один или несколько инструментов. ids Не следует выбирать средства в интерактивном режиме. Поддерживает массовое удаление, --dry-runа также --output json.

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

Для навыков инструментов выходные данные JSON перечисляют каждый навык для каждого агента и включают agent поле. Рассмотрим пример.

{
  "skills": [
    {
      "id": "my-skill",
      "agent": "copilot"
    }
  ]
}

Общие флаги

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

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

upgradeКоманды installи uninstall команды поддерживают --dry-run предварительные действия без внесения изменений.

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

• azd может автоматически запускаться в неинтерактивном режиме при обнаружении среды CI/CD или ИИ-агента.
• --no-prompt: Явно отключает интерактивные запросы.
• AZD_NON_INTERACTIVE=true: Явно отключает интерактивные запросы.
• AZD_NON_INTERACTIVE=false: Явно оставляет запрос подтверждения включённым даже в обнаруженных средах CI/CD или AI-агентов.
• Явные значения --no-prompt и AZD_NON_INTERACTIVE имеют приоритет над автоматическим определением среды.

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

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

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

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

azd tool upgrade az-cli github-copilot-cli

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

azd tool upgrade --all

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

azd tool upgrade --all --dry-run

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

Удалите один или несколько инструментов, передав их id значения.

azd tool uninstall az-cli azure-mcp-server

Предварительный просмотр удаления без внесения изменений:

azd tool uninstall vscode-bicep --dry-run

Запустите azd tool uninstall без идентификаторов инструментов для интерактивного выбора инструментов. Чтобы удалить навык из определенного агента ИИ, используйте --agent.

azd tool uninstall my-skill --agent copilot

Добавьте при --output json необходимости удаление сценария или конвейера.

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

Чтобы найти и установить рекомендуемые средства разработки Azure, явно запустите azd tool. В отличие от предыдущих версий, команды рабочего процесса, такие как azd init, azd up и azd deploy, больше не вызывают автоматический запрос на проверку инструментов.

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

• Передайте --no-prompt в команде.
• Задайте переменную AZD_NON_INTERACTIVE=trueсреды.
• Запустите в обнаруженной среде агента CI/CD или AI. azd может автоматически обходить интерактивные приглашения.

Чтобы запрос подтверждения оставался включённым в обнаруженной среде CI/CD или агента ИИ, задайте AZD_NON_INTERACTIVE=false. Явные значения --no-prompt и AZD_NON_INTERACTIVE имеют приоритет над автоматическим обнаружением.

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

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

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

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

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

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

• Что такое интерфейс командной строки разработчика Azure?
• Установка или обновление интерфейса командной строки разработчика Azure
• Общие сведения о командах командной строки разработчика Azure
• Управление конфигурацией интерфейса командной строки разработчика Azure
• Работа с расширениями Azure Developer CLI