Aspire — ポリグロット分散アプリケーションオーケストレーション

Aspire は、観測可能で本番環境対応の分散アプリケーションを構築するためのコードファースト、ポリグロットツールチェーンです。単一の AppHost プロジェクトからコンテナ、実行可能ファイル、およびクラウドリソースをオーケストレートします。ワークロードが C#、Python、JavaScript/TypeScript、Go、Java、Rust、Bun、Deno、PowerShell のいずれであっても対応します。

メンタルモデル： AppHost は指揮者です。楽器を演奏するのではなく、すべてのサービスにいつ開始するか、互いを見つける方法を指示し、問題を監視します。

詳細な参照資料は references/ フォルダに格納されています。必要に応じて読み込んでください。

---

参照資料

参照	読み込む際
CLI リファレンス	コマンドフラグ、オプション、詳細な使用方法
MCP サーバー	AI アシスタント用の MCP 設定、利用可能なツール
統合カタログ	MCP ツール経由での統合の検出、配線パターン
ポリグロット API	メソッドシグネチャ、チェーンオプション、言語固有パターン
アーキテクチャ	DCP 内部、リソースモデル、サービス検出、ネットワーキング、テレメトリ
ダッシュボード	ダッシュボード機能、スタンドアロンモード、GenAI ビジュアライザー
デプロイメント	Docker、Kubernetes、Azure Container Apps、App Service
テスト	AppHost に対する統合テスト
トラブルシューティング	診断コード、一般的なエラー、修正方法

---

1. Aspire ドキュメントの調査

Aspire チームは MCP サーバーを提供しており、AI アシスタント内で直接ドキュメントツールを利用できます。セットアップの詳細は MCP サーバー を参照してください。

Aspire CLI 13.2+ (推奨 — 組み込みドキュメント検索あり)

Aspire CLI 13.2 以上 を実行している場合 (aspire --version)、MCP サーバーにはドキュメント検索ツールが含まれています：

ツール	説明
list_docs	aspire.dev から利用可能なすべてのドキュメントを表示
search_docs	インデックス化されたドキュメント全体で重み付け字句検索を実行
get_doc	スラッグでドキュメントを取得

これらのツールは PR #14028 で追加されました。更新するには：aspire update --self --channel daily。

このアプローチの詳細については、David Pine のポストを参照してください：https://davidpine.dev/posts/aspire-docs-mcp-tools/

Aspire CLI 13.1 (統合ツールのみ)

13.1 では、MCP サーバーは統合の検索を提供しますが、ドキュメント検索は提供されません：

ツール	説明
list_integrations	利用可能な Aspire ホスティング統合を表示
get_integration_docs	特定の統合パッケージのドキュメントを取得

一般的なドキュメントクエリの場合は 13.1 で Context7 を主要なソースとして使用してください（下記を参照）。

フォールバック：Context7

Aspire MCP ドキュメントツールが利用不可（13.1）または MCP サーバーが実行されていない場合は Context7 (mcp_context7) を使用してください：

ステップ 1 — ライブラリ ID を解決（セッションあたり 1 回）：

libraryName: ".NET Aspire" で mcp_context7_resolve-library-id を呼び出します。

ランク	ライブラリ ID	使用時
1	/microsoft/aspire.dev	プライマリソース。ガイド、統合、CLI リファレンス、デプロイメント。
2	/dotnet/aspire	API 内部、ソースレベルの実装詳細。
3	/communitytoolkit/aspire	Microsoft 以外のポリグロット統合（Go、Java、Node.js、Ollama）。

ステップ 2 — ドキュメントをクエリ：

libraryId: "/microsoft/aspire.dev", query: "Python integration AddPythonApp service discovery"
libraryId: "/communitytoolkit/aspire", query: "Golang Java Node.js community integrations"

フォールバック：GitHub 検索（Context7 も利用不可の場合）

公式ドキュメントリポジトリで GitHub を検索してください：

• ドキュメントリポ： microsoft/aspire.dev — パス：src/frontend/src/content/docs/
• ソースリポ： dotnet/aspire
• サンプルリポ： dotnet/aspire-samples
• コミュニティ統合： CommunityToolkit/Aspire

---

2. 前提条件とインストール

必要条件	詳細
.NET SDK	10.0 以上（.NET 以外のワークロードでも必要 — AppHost は .NET）
コンテナランタイム	Docker Desktop、Podman、Rancher Desktop
IDE（オプション）	VS Code + C# Dev Kit、Visual Studio 2022、JetBrains Rider

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

# Windows PowerShell
irm https://aspire.dev/install.ps1 | iex

# 確認
aspire --version

# テンプレートをインストール
dotnet new install Aspire.ProjectTemplates

---

3. プロジェクトテンプレート

テンプレート	コマンド	説明
aspire-starter	aspire new aspire-starter	ASP.NET Core/Blazor スターター + AppHost + テスト
aspire-ts-cs-starter	aspire new aspire-ts-cs-starter	ASP.NET Core/React スターター + AppHost
aspire-py-starter	aspire new aspire-py-starter	FastAPI/React スターター + AppHost
aspire-apphost-singlefile	aspire new aspire-apphost-singlefile	空のシングルファイル AppHost

---

4. AppHost クイックスタート（ポリグロット）

AppHost はすべてのサービスをオーケストレートします。.NET 以外のワークロードはコンテナまたは実行可能ファイルとして実行されます。

var builder = DistributedApplication.CreateBuilder(args);

// インフラストラクチャ
var redis = builder.AddRedis("cache");
var postgres = builder.AddPostgres("pg").AddDatabase("catalog");

// .NET API
var api = builder.AddProject<Projects.CatalogApi>("api")
    .WithReference(postgres).WithReference(redis);

// Python ML サービス
var ml = builder.AddPythonApp("ml-service", "../ml-service", "main.py")
    .WithHttpEndpoint(targetPort: 8000).WithReference(redis);

// React フロントエンド (Vite)
var web = builder.AddViteApp("web", "../frontend")
    .WithHttpEndpoint(targetPort: 5173).WithReference(api);

// Go ワーカー
var worker = builder.AddGolangApp("worker", "../go-worker")
    .WithReference(redis);

builder.Build().Run();

完全な API シグネチャは ポリグロット API を参照してください。

---

5. コアコンセプト（概要）

コンセプト	キーポイント
Run vs Publish	aspire run = ローカル開発（DCP エンジン）。aspire publish = デプロイメントマニフェストを生成。
サービス検出	環境変数経由の自動化：ConnectionStrings__<name>、services__<name>__http__0
リソースライフサイクル	DAG 順序 — 依存関係が最初に開始されます。.WaitFor() はヘルスチェックをゲート。
リソースタイプ	ProjectResource、ContainerResource、ExecutableResource、ParameterResource
統合	13 カテゴリ全体で 144+。ホスティングパッケージ（AppHost）+ クライアントパッケージ（サービス）。
ダッシュボード	リアルタイムログ、トレース、メトリクス、GenAI ビジュアライザー。aspire run で自動実行。
MCP サーバー	AI アシスタントは CLI（STDIO）経由で実行中のアプリをクエリしてドキュメントを検索。
テスト	Aspire.Hosting.Testing — xUnit/MSTest/NUnit で完全な AppHost をスピンアップ。
デプロイメント	Docker、Kubernetes、Azure Container Apps、Azure App Service。

---

6. CLI クイックリファレンス

Aspire CLI 13.1 の有効なコマンド：

コマンド	説明	ステータス
aspire new <template>	テンプレートから作成	安定
aspire init	既存プロジェクトで初期化	安定
aspire run	すべてのリソースをローカルで開始	安定
aspire add <integration>	統合を追加	安定
aspire publish	デプロイメントマニフェストを生成	プレビュー
aspire config	設定を管理	安定
aspire cache	ディスクキャッシュを管理	安定
aspire deploy	定義されたターゲットにデプロイ	プレビュー
aspire do <step>	パイプラインステップを実行	プレビュー
aspire update	統合を更新（または --self で CLI）	プレビュー
aspire mcp init	AI アシスタント用の MCP を設定	安定
aspire mcp start	MCP サーバーを開始	安定

フラグ付きの完全なコマンドリファレンス：CLI リファレンス。

---

7. 一般的なパターン

新しいサービスを追加

1. サービスディレクトリを作成（任意の言語）
2. AppHost に追加：Add*App() または AddProject<T>()
3. 依存関係を配線：.WithReference()
4. 必要に応じてヘルスチェックをゲート：.WaitFor()
5. 実行：aspire run

Docker Compose からの移行

1. aspire new aspire-apphost-singlefile（空の AppHost）
2. 各 docker-compose サービスを Aspire リソースに置き換え
3. depends_on → .WithReference() + .WaitFor()
4. ports → .WithHttpEndpoint()
5. environment → .WithEnvironment() または .WithReference()

---

8. キー URL

リソース	URL
ドキュメント	https://aspire.dev
ランタイムリポ	https://github.com/dotnet/aspire
ドキュメントリポ	https://github.com/microsoft/aspire.dev
サンプル	https://github.com/dotnet/aspire-samples
コミュニティツールキット	https://github.com/CommunityToolkit/Aspire
ダッシュボードイメージ	mcr.microsoft.com/dotnet/aspire-dashboard
Discord	https://aka.ms/aspire/discord
Reddit	https://www.reddit.com/r/aspiredotdev/