Azure Developer CLI (azd) には、Azure アプリケーションのビルドと配布に使用される一般的なツールの状態を検出、インストール、アップグレード、およびチェックするための組み込みの azd tool コマンド グループが含まれています。 一貫性のあるサブコマンドのセットの背後にある各プラットフォーム ( winget、 brew、 apt、 npm、VS Code code CLI など) の基になるパッケージ マネージャーをラップし、対話型の使用と自動化の両方をサポートします。
azd toolの一般的なユース ケースは次のとおりです。
- 1 つのコマンドを使用して、新しいマシンに推奨されるすべての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 AI 拡張機能 |
library |
Optional | azd extension |
正確なインストール方法は、オペレーティング システムとマシンで使用可能なパッケージ マネージャーによって異なります。
Note
VS Code 拡張機能では、codeで PATH CLI を使用できる必要があります。
code使用できない場合、ツールはインストールされていないと表示され、azd toolを使用してインストールすることはできません。
コマンドの概要
azd tool コマンド・グループには、以下のサブコマンドが含まれています。
| 命令 | Description |
|---|---|
azd tool |
インストール済みで使用可能なツールと、1 つの手順でインストールするツールのプロンプトを表示する対話型フローを開始します。 |
azd tool list |
インストールの状態、バージョン、カテゴリ、優先度など、登録されているすべてのツールを一覧表示します。 |
azd tool show <id> |
プラットフォームごとのインストール戦略やプロジェクト Web サイトなど、特定のツールの詳細情報を表示します。 |
azd tool check |
インストールされているツールで利用可能な更新プログラムを確認します。 |
azd tool install [ids...] |
idで 1 つ以上のツールをインストールします。 |
azd tool upgrade [ids...] |
インストールされている 1 つ以上のツールをアップグレードします。 |
azd tool uninstall [ids...] |
1 つ以上のツールを削除します。 ツールを対話的に選択するには、 ids を省略します。 一括削除、 --dry-run、および --output jsonをサポートします。 |
すべてのコマンドは、スクリプトやパイプラインに適したマシン読み取り可能な出力の --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