azd tool を使用してAzure開発ツールを管理する

Azure Developer CLI (azd) には、Azure アプリケーションのビルドと配布に使用される一般的なツールの状態を検出、インストール、アップグレード、およびチェックするための組み込みの azd tool コマンド グループが含まれています。 一貫性のあるサブコマンドのセットの背後にある各プラットフォーム ( winget、 brew、 apt、 npm、VS Code code CLI など) の基になるパッケージ マネージャーをラップし、対話型の使用と自動化の両方をサポートします。

azd toolの一般的なユース ケースは次のとおりです。

• 1 つのコマンドを使用して、新しいマシンに推奨されるすべてのAzure開発ツールをインストールします。
• チームまたは CI エージェントのセット全体で開発環境を標準化する。
• 特定のコンピューターにインストールされているAzureツール (およびバージョン) を監査する。
• インストールされているツールに対する更新プログラムの確認と適用。
• 非対話型フラグと JSON 出力を使用したパイプラインでのスクリプト ツールのセットアップ。

組み込みツール

組み込みのレジストリには、次のツールが含まれています。 カテゴリ列と優先度列を使用して、特定のワークフローに適用されるツールを決定します。

正確なインストール方法は、オペレーティング システムとマシンで使用可能なパッケージ マネージャーによって異なります。

コマンドの概要

azd tool コマンド・グループには、以下のサブコマンドが含まれています。

すべてのコマンドは、スクリプトやパイプラインに適したマシン読み取り可能な出力の --output json をサポートします。

ツール スキルの場合、JSON 出力には各エージェントの各スキルが一覧表示され、 agent フィールドが含まれます。 例えば次が挙げられます。

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

共通フラグ

installおよびupgradeでは、次のフラグを使用できます。

• --all: 対象となるすべてのツールをインストールまたはアップグレードします。 installの場合、このコマンドには推奨されるすべてのツールが含まれます。 upgradeの場合、このコマンドには、更新プログラムが利用可能なすべてのインストール済みツールが含まれます。

install、upgrade、およびuninstallコマンドは、変更を加えずにアクションをプレビューする--dry-runをサポートします。

次のオプションは、プロンプトの動作を制御します。

• azd は、CI/CD または AI エージェント環境を検出すると、非対話型モードで自動的に実行できます。
• --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>を実行して、サポートされている各プラットフォームとプロジェクト Web サイトに適用されるインストール戦略など、特定のツールを検査します。

azd tool show az-cli

1 つ以上のツールをインストールする

1 つ以上のツール id 値を渡して、特定のツールをインストールします。

azd tool install az-cli vscode-bicep

推奨されるすべてのツールをインストールするには、 --allを使用します。

azd tool install --all

インストール コマンドを実行せずにプレビューするには、 --dry-runを追加します。

azd tool install az-cli --dry-run

サブコマンドなしで azd tool を実行すると、インストールされているツールを表示し、追加のツールを選択して、1 つのステップでインストールする対話型フローが開始されます。

更新プログラムを確認する

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値を渡して、1 つ以上のツールを削除します。

azd tool uninstall az-cli azure-mcp-server

変更を加えずに削除をプレビューする:

azd tool uninstall vscode-bicep --dry-run

ツール ID なしで azd tool uninstall を実行して、ツールを対話形式で選択します。 特定の AI エージェントからスキルを削除するには、 --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 または AI エージェント環境でプロンプトを有効にしたままにするには、 AZD_NON_INTERACTIVE=false設定します。 明示的な --no-prompt 値と AZD_NON_INTERACTIVE 値は自動検出をオーバーライドします。

CI と非対話型のシナリオ

azd tool コマンド グループは、次のオプションを使用してパイプラインとスクリプトをサポートします。

• 対話型の選択を回避するには、install、upgrade、およびuninstallで位置指定id引数を使用します。
• --no-promptの追加、AZD_NON_INTERACTIVE=trueの設定、または CI/CD または AI エージェント環境での自動検出に依存して、プロンプトを抑制します。
• 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 Developer CLI とは
• Azure Developer CLI をインストールまたは更新します
• Azure Developer CLI コマンドの概要
• Manage Azure Developer CLI の構成
• Azure Developer CLI 拡張機能を使用した作業