Aspire CLI の概要

Aspire CLI (aspire コマンド) は、polyglot Aspire プロジェクトを作成、管理、実行、発行するためのコマンドライン機能を提供するクロスプラットフォーム ツールです。 Aspire CLI を使用して、開発ワークフローを合理化し、分散アプリケーションのサービスを調整します。

Aspire CLI は、対話型の最初のエクスペリエンスです。

• Aspire CLI をインストールします。
• aspire コマンド リファレンス。

テンプレートを使用する

コマンド リファレンス: aspire new

aspire new コマンドは対話型の最初の CLI エクスペリエンスであり、1 つ以上のAspire プロジェクトを作成するために使用されます。 Aspire CLI では、プロジェクトの作成の一環として、最新のAspire プロジェクト テンプレートがdotnet システムにインストールされます。

aspire new コマンドを使用して、テンプレートの一覧からAspire プロジェクトを作成します。 テンプレートを選択すると、プロジェクトの名前が設定され、出力フォルダーが選択 aspire 、最新のテンプレートがダウンロードされ、1 つ以上のプロジェクトが生成されます。

コマンド ライン パラメーターを使用して Aspire プロジェクトの作成を自動化できますが、 Aspire CLI は対話型のエクスペリエンスです。

Aspire AppHost を起動する

コマンド リファレンス: aspire run

aspire run コマンドは、開発モードで AppHost プロジェクトを実行します。これにより、Aspire環境が構成され、AppHost によって定義されたリソースがビルドおよび開始され、Web ダッシュボードが起動され、エンドポイントの一覧が出力されます。

aspire runが開始されると、現在のディレクトリで AppHost プロジェクトが検索されます。 プロジェクトが見つからない場合、サブディレクトリは見つかるまで検索されます。 AppHost プロジェクトが見つからない場合、 Aspire は停止します。 プロジェクトが見つかったら、 Aspire CLI は次の手順を実行します。

• Aspireのローカル ホスティング証明書がインストールされ、信頼されていることをインストールまたは確認します。
• AppHost プロジェクトとそのリソースをビルドします。
• AppHost とそのリソースを開始します。
• ダッシュボードを開始します。

次のスニペットは、 aspire run コマンドによって表示される出力の例です。

Dashboard:  https://localhost:17178/login?t=17f974bf68e390b0d4548af8d7e38b65

    Logs:  /home/vscode/.aspire/cli/logs/apphost-1295-2025-07-14-18-16-13.log

統合の追加

コマンド リファレンス: aspire add

aspire add コマンドを使用すると、公式の統合パッケージを AppHost プロジェクトに簡単に追加できます。 これは、IDE を使用した NuGet 検索の代わりに使用します。 統合パッケージの名前または NuGet ID がわかっている場合は、 aspire add <name|id> を実行できます。 名前または ID を省略すると、選択するパッケージの一覧がツールに表示されます。 部分的な名前または ID を指定すると、指定された値に一致する項目でパッケージの一覧がフィルター処理されます。

Aspire アプリケーションの公開 (プレビュー)

コマンド リファレンス: aspire publish

aspire publish コマンドは、リソースをディスクにシリアル化して発行します。 このコマンドを実行すると、 Aspire は、登録済みの PublishingCallbackAnnotation リソース注釈を宣言された順序で呼び出します。 これらの注釈は、デプロイ ツールで使用できるようにリソースをシリアル化します。

一部の統合では、次のような PublishingCallbackAnnotation が自動的に登録されます。

• AzureEnvironmentResource は Bicep アセットを生成します。
• DockerComposeEnvironmentResource は docker-compose yaml を生成します。
• KubernetesEnvironmentResource は Kubernetes Helm チャートを生成します。

Aspire アプリケーションのデプロイ (プレビュー)

コマンド リファレンス: aspire deploy

aspire deploy コマンドは、aspire publishに似ています。 Aspireが発行注釈を呼び出してリソースをディスクにシリアル化すると、リソース注釈DeployingCallbackAnnotation宣言された順序で呼び出されます。

Aspire 9.4 の時点で、Aspireにはリソースの既定のデプロイ注釈は含まれていません。独自のデプロイ注釈を作成するには、DeployingCallbackAnnotationを使用する必要があります。

Aspire構成の管理

コマンド リファレンス: aspire config

aspire config コマンドを使用すると、CLI 構成設定Aspire管理できます。 これを使用して、CLI の動作を制御する構成値を指定します。list、get、set、または delete。 このコマンドは、機能のオンとオフを切り替えるためにも使用されます。

CLI 構成の詳細については、Aspire 構成とはを参照してください。

リソース コンテキストでコマンドを実行する (プレビュー)

コマンド リファレンス: aspire exec

aspire exec コマンドは、特定のAspire リソースのコンテキストでコマンドを実行し、そのリソースの構成 (環境変数、接続文字列、作業ディレクトリなど) を継承します。 これは、アプリケーションと同じ構成でコマンドを実行する必要がある Entity Framework 移行の実行などのシナリオで特に便利です。 たとえば、 aspire exec --resource api -- dotnet ef migrations add Init を実行して、適切なデータベース接続文字列が自動的に構成された Entity Framework コマンドを実行できます。