.NET .NET Aspire のセットアップとツール

2025-08-22

.NET .NET Aspire には、クラウドネイティブアプリの作成と構成に役立つツールが含まれています。このツールには、.NET Aspire、Visual Studio、CLI ワークフローの Visual Studio Code の使用を効率化するための便利なスタータープロジェクトテンプレートやその他の機能が含まれています。前のセクションでは、.NET.NET Aspire ツールを使用する方法と、次のタスクについて説明します。

.NET .NET Aspire とその依存関係をインストールする
Visual Studio、Visual Studio Code、または .NET CLI を使用してスタータープロジェクトテンプレートを作成する
.NET .NET Aspire 統合をインストールする
.NET .NET Aspire ダッシュボードを操作する

.NET .NET Aspire の前提条件をインストールする

.NET .NET Aspireを使用するには、次のものがローカルにインストールされている必要があります。

.NET 8.0 または .NET 9.0。
- .NET .NET Aspire 9.4 以降では、.NET 10 Preview 5 以降がサポートされています。
OCI 準拠のコンテナーランタイム。次に例を示します。
- Docker デスクトップ
- Podman
  - 詳細については、「コンテナーランタイム」を参照してください。
次のような統合開発者環境 (IDE) またはコードエディター。
- Visual Studio 2022 バージョン 17.9 以降 (任意)
- Visual Studio Code (省略可能)
  - C# Dev Kit: 拡張機能（省略可能）
- JetBrains Rider と .NET.NET Aspire プラグイン (オプション)

Tip

または、.NET または .NET Aspireを使用して、GitHub ソリューションを開発することもできます。

Visual Studio 2022 17.9 以降には、Web & Cloud ワークロードをインストールするときに既定で最新の .NET.NET Aspire SDK が含まれています。

.NET .NET Aspire テンプレート

.NET .NET Aspire には、一連のソリューションテンプレートとプロジェクトテンプレートが用意されています。これらのテンプレートは、お気に入りの .NET 開発者統合環境で使用できます。これらのテンプレートを使用して、完全な .NET Aspire ソリューションを作成したり、既存の .NET Aspire ソリューションに個々のプロジェクトを追加したりできます。

.NET .NET Aspire テンプレートをインストールする

.NET Aspireに Visual Studio テンプレートをインストールするには、Visual Studio 17.12 以降を使用していない限り、手動でインストールする必要があります。 Visual Studio 17.9 から 17.11 の場合は、次の手順に従います。

Visual Studioを開きます。
Tools>NuGet パッケージマネージャー>パッケージマネージャーコンソールに移動します。
次のコマンドを実行してテンプレートをインストールします。

dotnet new install Aspire.ProjectTemplates

Visual Studio 17.12 以降では、.NET Aspire テンプレートが自動的にインストールされます。

これらのテンプレートをインストールするには、dotnet new install コマンドを使用して、Aspire.ProjectTemplates NuGet 識別子を渡します。

dotnet new install Aspire.ProjectTemplates

特定のバージョンをインストールするには、パッケージ名にバージョン番号を追加します。

dotnet new install Aspire.ProjectTemplates::9.4.0

.NET .NET Aspire テンプレートを一覧表示する

.NET Aspire テンプレートは、Visual Studio 17.9 以降をインストールすると自動的にインストールされます。使用可能な .NET.NET Aspire テンプレートを確認するには、の >>Visual Studio を選択し、検索バーで "Aspire" を検索します (Alt+S)。使用可能な .NET.NET Aspire プロジェクトテンプレートの一覧が表示されます。

C# DevKit がインストールされている Visual Studio Code で使用可能なテンプレートを表示するには、.NET ビューでフォルダーが開かなくなったときに Project の作成] ボタンを選択します。

次に、検索バーで "Aspire" を検索して、使用可能な .NET Aspire プロジェクトテンプレートを確認します。

.NET .NET Aspire テンプレートがインストールされていることを確認するには、dotnet new list コマンドを使用して、aspire テンプレート名を渡します。

dotnet new list aspire

コンソールの出力は次のようになります。

dotnet new list aspire
These templates matched your input: 'aspire'

Template Name                      Short Name              Language  Tags
---------------------------------  ----------------------  --------  -------------------------------------------------------
.NET Aspire AppHost               aspire-apphost          [C#]      Common/.NET Aspire/Cloud
.NET Aspire Empty App              aspire                  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Service Defaults       aspire-servicedefaults  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Starter App            aspire-starter          [C#]      Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud
.NET Aspire Test Project (MSTest)  aspire-mstest           [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (NUnit)   aspire-nunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (xUnit)   aspire-xunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test

詳細については、.NET.NET Aspire テンプレートのを参照してください。

コンテナーランタイム

.NET Aspire では、 Docker Desktop や Podman など、複数の OCI 互換ランタイムを使用してコンテナーを実行できます。一部のユーザーは、Rancher Desktop (特に Docker CLI を使用するように構成されている場合) を使用して成功を報告していますが、これは公式にサポートまたは定期的にテストされるシナリオではありません。既定のインストールで Rancher Desktop を使用することは可能ですが、公式にサポートまたは検証されたアプローチではありません。 Rancher Desktop で問題が発生した場合は、お知らせくださいが、修正プログラムが優先されない可能性があることに注意してください。

Docker Desktop は、.NET.NET Aspire の開発者の間で最も人気のあるコンテナーランタイムであり、コンテナーを構築および実行するための使い慣れた、広くサポートされている環境を提供します。
Podman は、 Dockerに代わるオープンソースのデーモンレスです。 Open Container Initiative (OCI) コンテナーの構築と実行がサポートされているため、軽量ソリューションを好む開発者にとって柔軟な選択肢となります。

ホスト環境にDockerとPodmanがインストールされている場合、既定では.NET AspireはDockerを使用します。 .NET Aspire 環境変数を Podmanに設定することで、代わりに ASPIRE_CONTAINER_RUNTIME を使用するように podman に指示できます。

Linux
Windows

export ASPIRE_CONTAINER_RUNTIME=podman

詳細については、「にをインストールする」を参照してください。

[System.Environment]::SetEnvironmentVariable("ASPIRE_CONTAINER_RUNTIME", "podman", "User")

詳細については、「Podman を Windowsにインストールする方法」を参照してください。

WSL ( Linux用 Windows サブシステム) に関する考慮事項

WSL で Podman を使用する場合は、シェルエイリアスとして定義されているだけでなく、 podman 実行可能ファイルが PATH で使用できることを確認します。 .NET .NET Aspire は、システム PATH で実行可能ファイルを検索することでコンテナーランタイムを解決し、このプロセス中にシェルエイリアスが認識されません。

一般的な問題と解決方法:

別の WSL ディストリビューションにインストールPodman: Podmanが.NET Aspire アプリケーションとは異なる WSL ディストリビューションにインストールされている場合、podman コマンドは現在のディストリビューションの PATH で使用できない可能性があります。

解決策: Podman.NET Aspire アプリケーションを実行している WSL ディストリビューションに直接インストールするか、PATH 内のディレクトリ (Podman など) に/usr/local/bin実行可能ファイルへのシンボリックリンクを作成します。
シェルエイリアスの使用: alias podman='podman-remote-static-linux_amd64'や同様のファイルに~/.bash_aliasesなどのシェルエイリアスがある場合、.NET.NET Aspireはコンテナーランタイムを見つけることができません。

解決策: エイリアスを使用する代わりに、シンボリックリンクを作成するか、 Podman 実行可能ファイルを含むディレクトリを PATH に追加します。
```
# Option 1: Create a symbolic link
sudo ln -s /path/to/podman-remote-static-linux_amd64 /usr/local/bin/podman

# Option 2: Add to PATH in your shell profile
echo 'export PATH="/path/to/podman/directory:$PATH"' >> ~/.bashrc
source ~/.bashrc
```

セットアップを確認する:次を実行して、 Podman が正しく構成されていることを確認できます。

which podman
podman --version

どちらのコマンドも成功し、 .NET.NET Aspire アプリケーションを実行する前に有効な結果を返す必要があります。

Tip

WSL 環境で Podman に関する問題が発生した場合は、特定のトラブルシューティングガイダンスについては、コンテナーランタイム 'podman' が WSL で見つかりませんでしたを参照してください。

.NET .NET Aspire ダッシュボード

.NET .NET Aspire AppHost プロジェクトを公開するテンプレートには、ログ、トレース、環境の構成など、アプリのさまざまな側面を監視および検査するために使用される便利な開発者ダッシュボードも含まれています。このダッシュボードは、ローカル開発エクスペリエンスを向上させるために設計されており、アプリの全体的な状態と構造の概要を示します。

.NET .NET Aspire ダッシュボードは、アプリの実行中にのみ表示され、* を起動すると自動的に開始されます。AppHost プロジェクト。 Visual Studio および Visual Studio Code は、ブラウザーでアプリと .NET Aspire ダッシュボードの両方を自動的に起動します。 .NET CLI を使用してアプリを起動する場合は、出力からダッシュボードの URL をコピーしてブラウザーに貼り付けるか、Ctrl キー 押しながら し、リンクを選択します (ターミナルでハイパーリンクがサポートされている場合)。

左側のナビゲーションには、ダッシュボードのさまざまな部分へのリンクが用意されています。各部分について、次のセクションで説明します。

.NET .NET Aspire ダッシュボードはスタンドアロンモードでも使用できます。詳細については、「スタンドアロン .NET.NET Aspire ダッシュボード」を参照してください。

Visual Studio ツール類

Visual Studio には、 .NET Aspire 統合と AppHost オーケストレータープロジェクトを操作するための追加機能が用意されています。現在、これらの機能の一部は、Visual Studio Code または CLI で使用できるわけではありません。

統合パッケージを追加する

.NET Aspireを使用して、他の NuGet パッケージと同様に、Visual Studio 統合をアプリに追加します。ただし、Visual Studio には、.NET Aspire 統合を直接追加するための UI オプションも用意されています。

で、統合を追加するプロジェクトを右選択し、[ パッケージの追加]選択します。..。
パッケージマネージャーが開き、.NET.NET Aspire 統合用に事前に構成された検索結果 (フィルター条件の設定) が表示され、目的の統合を簡単に参照して選択できます。

統合の詳細については、統合の概要参照してください。

ホスティングパッケージを追加する

.NET .NET Aspire ホスティングパッケージは、アプリが依存または使用する可能性があるさまざまなリソースと依存関係を構成するために使用されます。ホスティングパッケージは、* に追加されるという点で、他の統合パッケージと区別されます。AppHost プロジェクト。ホスティングパッケージをアプリに追加するには、次の手順に従います。

Visual Studioで、*.AppHost プロジェクトを右クリックして選択し、追加>.NET.NET Aspire パッケージ... を選択。
パッケージマネージャーが開き、.NET.NET Aspire ホスティングパッケージの検索結果が事前に構成 (フィルター条件の設定) され、目的のパッケージを簡単に参照して選択できます。

オーケストレーションプロジェクトを追加する

次の手順 .NET.NET Aspire 使用して、オーケストレーションプロジェクトを既存のアプリに追加できます。

Visual Studioで既存のプロジェクトを右クリックし、[追加] で>.NET.NET Aspire Orchestrator サポートを選択します。
ダイアログウィンドウが開き、ソリューションに追加される*.AppHost および *.ServiceDefaults プロジェクトの概要が表示されます。
[OK] 選択すると、次の変更が適用されます。
- *.AppHost と *.ServiceDefaults オーケストレーションプロジェクトがソリューションに追加されます。
- builder.AddServiceDefaults の呼び出しが、元のプロジェクトの Program.cs ファイルに追加されます。
- 元のプロジェクトへの参照が、* の Program.cs ファイルに追加されます。AppHost プロジェクト。

オーケストレーションの詳細については、オーケストレーションの概要参照してください。

オーケストレーションに参加する

では、新しいプロジェクトワークフロー中にのオーケストレーションに登録するオプションが提供されます。このオプションを選択すると、選択されたプロジェクトテンプレートと共に、Visual Studio が の *.AppHost プロジェクトと の *.ServiceDefaults プロジェクトを作成します。

テストプロジェクトを作成する

を使用していて、[アプリケーションの開始] テンプレート選択すると、テストプロジェクトを含めることができます。このテストプロジェクトは、テストの開始点として使用できるサンプルテストを含む xUnit プロジェクトです。

詳細については、「最初の .NET.NET Aspire テストを記述する」を参照してください。

Visual Studio Code ツール類

Visual Studio Code C# Dev Kit プロジェクトの作成と開発には、と共に .NETを使用できます。 .NET Aspireで新しい Visual Studio Code プロジェクトを作成するには、.NET ビューで Project ボタンを選択し、.NET.NET Aspire テンプレートのいずれかを選択します。

新しい .NET Aspire プロジェクトを作成したら、アプリを実行してデバッグし、ブレークポイントをステップ実行し、Visual Studio Code デバッガーを使用して変数を検査します。

🖥️ Aspireコマンドラインインターフェース (CLI)

🧪 Aspire CLI はまだ プレビュー段階であり 、開発中です。今後のリリースでは、より多くの機能と洗練された機能を期待してください。

Unix
Windows

Aspire CLI をインストールするには、ターミナルで次のコマンドを実行します。

curl -sSL https://aspire.dev/install.sh | bash

スクリプトオプション

Unix インストールスクリプト (install.sh) では、次のオプションがサポートされています。

Parameter	短縮形式	Description	既定値
`--install-path`	`-i`	CLI をインストールするディレクトリ	`$HOME/.aspire/bin`
`--version`		ダウンロードする Aspire CLI のバージョン	`9.4`
`--quality`	`-q`	ダウンロードする品質 (`dev`、 `staging`、 `release`)	`release`
`--os`		オペレーティングシステム (指定されていない場合は自動検出)	自動検出
`--arch`		アーキテクチャ (指定されていない場合は自動検出)	自動検出
`--keep-archive`	`-k`	インストール後にダウンロードしたアーカイブファイルを保持する	`false`
`--verbose`	`-v`	詳細出力を有効にする	`false`
`--help`	`-h`	ヘルプメッセージを表示する

品質オプション

--quality オプションによって、インストールする Aspire CLI のビルドが決まります。

dev: main ブランチからの最新のビルド (開発ビルド)。
staging: 現在のリリースブランチからのビルド (プレリリースビルド)。
release: 最新の一般公開リリース (安定したビルド)。

使用例

カスタムディレクトリにインストールします。

curl -sSL https://aspire.dev/install.sh | bash -s -- --install-path "/usr/local/bin"

詳細出力を使用してインストールします。

curl -sSL https://aspire.dev/install.sh | bash -s -- --verbose

特定のバージョンをインストールします。

curl -sSL https://aspire.dev/install.sh | bash -s -- --version "9.4"

開発ビルドをインストールします。

curl -sSL https://aspire.dev/install.sh | bash -s -- --quality "dev"

既定のインストールパス

このスクリプトは、Aspire CLI を標準として $HOME/.aspire/bin にインストールします。

Aspire CLI をインストールするには、ターミナルで次のコマンドを実行します。

Invoke-Expression "& { $(Invoke-RestMethod https://aspire.dev/install.ps1) }"

スクリプトオプション

Windows インストールスクリプト (install.ps1) では、次のオプションがサポートされています。

Parameter	Description	既定値
`-InstallPath`	CLI をインストールするディレクトリ	`%USERPROFILE%\.aspire\bin`
`-Version`	ダウンロードする Aspire CLI のバージョン	`9.4`
`-Quality`	ダウンロードする品質 (`dev`、 `staging`、 `release`)	`release`
`-OS`	オペレーティングシステム (指定されていない場合は自動検出)	自動検出
`-Architecture`	アーキテクチャ (指定されていない場合は自動検出)	自動検出
`-KeepArchive`	インストール後にダウンロードしたアーカイブファイルを保持する	`false`
`-Help`	ヘルプメッセージを表示する

品質オプション

-Quality オプションによって、インストールする Aspire CLI のビルドが決まります。

dev: main ブランチからの最新のビルド (開発ビルド)。
staging: 現在のリリースブランチからのビルド (プレリリースビルド)。
release: 最新の一般公開リリース (安定したビルド)。

使用例

カスタムディレクトリにインストールします。

Invoke-Expression "& { $(Invoke-RestMethod https://aspire.dev/install.ps1) } -InstallPath 'C:\Tools\Aspire'"

詳細出力を使用してインストールします。

Invoke-Expression "& { $(Invoke-RestMethod https://aspire.dev/install.ps1) } -Verbose"

特定のバージョンをインストールします。

Invoke-Expression "& { $(Invoke-RestMethod https://aspire.dev/install.ps1) } -Version '9.4'"

開発ビルドをインストールします。

Invoke-Expression "& { $(Invoke-RestMethod https://aspire.dev/install.ps1) } -Quality 'dev'"

既定のインストールパス

このスクリプトは、Aspire CLI を標準として %USERPROFILE%\.aspire\bin にインストールします。

こちらも参照ください

.NET で開発プロキシ .NET Aspire 使用する

次の方法で共有

.NET .NET Aspire のセットアップとツール

.NET .NET Aspire の前提条件をインストールする

.NET .NET Aspire テンプレート

.NET .NET Aspire テンプレートをインストールする

.NET .NET Aspire テンプレートを一覧表示する

コンテナー ランタイム

WSL ( Linux用 Windows サブシステム) に関する考慮事項

.NET .NET Aspire ダッシュボード

Visual Studio ツール類

統合パッケージを追加する

ホスティング パッケージを追加する

オーケストレーション プロジェクトを追加する

オーケストレーションに参加する

テスト プロジェクトを作成する

Visual Studio Code ツール類

🖥️ Aspireコマンドラインインターフェース (CLI)

スクリプト オプション

品質オプション

使用例

既定のインストール パス

こちらも参照ください

フィードバック

その他のリソース

コンテナーランタイム

ホスティングパッケージを追加する

オーケストレーションプロジェクトを追加する

テストプロジェクトを作成する

スクリプトオプション

既定のインストールパス