既存のアプリを Aspireify する

最初にプログラミング言語を選択しましょう

このガイドでは、既存のアプリケーションに Aspire のオーケストレーションを追加する方法を紹介します。アプリが C#、Python、JavaScript、またはそれらの組み合わせで書かれていても問題ありません。ゼロから始めるのではなく、 aspire init コマンドを使って、現在のプロジェクトに段階的に Aspire を取り入れていきます。

既存のアプリに Aspire を追加する理由は？

分散アプリケーションが成長すると、複数のサービスを調整する作業は、設定ファイルの乱立、ハードコードされた URL、壊れやすい起動スクリプトといった“絡み合った糸”のようになっていきます。環境ごとに異なる接続文字列の管理、サービス間依存関係の手作業での配線、マイクロサービス全体にまたがる問題の追跡…。開発環境のセットアップも儀式のようになり、「データベース → キャッシュ → サービス A → サービス B」の順で起動しなければならず、わずかな手順ミスで最初からやり直し、ということも珍しくありません。

Aspire は、これらの複雑さをひとつの統合オーケストレーション層によって解消します。アプリケーション全体を一つのシステムとして扱い、コード内でサービスとその関係を一度定義するだけで (AppHost)、Aspire が自動的にサービス検出を行い、設定を挿入し、ログ・トレース・メトリクスを含むダッシュボードまで提供します。サービスが C#、Python、JavaScript のいずれで書かれていても、あるいはそれらが混在していても、開発からデプロイまで一貫した体験が得られます。

そして何より魅力的なのは、Aspire を段階的に採用できることです。まずはオーケストレーションを導入し、準備ができたら可観測性を追加し、必要に応じて外部サービスを統合するといった柔軟な進め方ができます。既存のコードベースに大幅な変更を加える必要はほとんどなく、もし Aspire が合わないと感じた場合でも元に戻すことができます。

事前準備

始める前に、アプリケーションの使用言語に応じて、次の要件を満たすようにインストールされていることを確認してください。

共通の要件

.NET SDK 10.0 以降 — アプリケーションの言語に関係なく、Aspire AppHost に必要です。
Aspire CLI のインストール — オーケストレーションやデプロイのコマンドに必要です。
Aspire を追加する既存のアプリケーション。

開発言語ごとの要件

C# アプリケーションの場合:

1 つ以上の .NET または ASP.NET Core プロジェクト (.csproj) を含むソリューション
Visual Studio 2022 17.13 以降、Visual Studio Code、JetBrains Rider（任意）

プロジェクトタイプの例:

ASP.NET Core Minimal API
ASP.NET Core Razor Pages または Blazor アプリ
コンソールアプリケーション
Worker サービス
gRPC サービス
Azure Functions

Python アプリケーションの場合:

Python 3.10 以降がインストールされていること
パッケージ管理のための uv (推奨) または pip
既存の Python アプリケーション

アプリケーションタイプの例:

FastAPI web アプリケーション
Flask web アプリケーション
Django アプリケーション
Python スクリプトや Worker プロセス
Streamlit などのその他 Python Web フレームワーク

JavaScript/TypeScript アプリケーションの場合:

Node.js 22 以降がインストールされていること
パッケージ管理のための npm, yarn, or pnpm
既存の JavaScript／TypeScript アプリケーション

アプリケーションタイプの例:

React、 Vue、 Svelte アプリケーション (特に Vite ベース)
Node.js/Express API
Next.js アプリケーション
Angular アプリケーション
TypeScript バックエンドサービス

プロセスの概要

既存のアプリケーションに Aspire を追加する手順は、主に次のステップで進めます:

Aspire 対応を初期化 — aspire init を使用して AppHost（オーケストレーション層）を追加します。
アプリケーションを追加 — AppHost に C#、Python、JavaScript のアプリケーションを登録します。
テレメトリーを構成（任意） — 可観測性のために OpenTelemetry を追加します。
統合を追加（任意） — データベース、キャッシュ、メッセージキューなどを接続します。
実行と検証 — Aspire オーケストレーションでアプリケーションの動作を確認します。

Aspire 対応を初期化

aspire init コマンドは、既存のアプリケーションに Aspire を追加するための出発点です。このコマンドはプロジェクト構造を分析し、サービスをオーケストレーションする AppHost を追加します。

プロジェクトのディレクトリに移動します:
ソリューションのディレクトリに移動
```
cd /path/to/your-solution
```
プロジェクトルートに移動
```
cd /path/to/your-project
```
ワークスペースルートに移動
```
cd /path/to/your-workspace
```
aspire init を実行して Aspire を初期化:
Aspire を初期化
```
aspire init
```
aspire init コマンドは、既定で 対話モード で実行されます。実行すると次の処理が行われます。:
- 既存のソリューション構成を検出する - プロジェクトベースの AppHost（AppHost.cs を含む AppHost プロジェクト）を作成する - プロジェクトを分析し、オーケストレーションに追加すべきものを提案する - 必要な Aspire パッケージをインストールする
- 既存のプロジェクト構成を検出する - ファイルベースの AppHost（apphost.cs）を作成する - Python アプリケーションを分析し、オーケストレーションに追加すべきものを提案する - 必要な Aspire パッケージをインストールする
- 既存のワークスペース構成を検出する - ファイルベースの AppHost（apphost.cs）を作成する - JavaScript / Node.js アプリケーションを分析し、オーケストレーションに追加すべきものを提案する - 必要な Aspire パッケージをインストールする
aspire init コマンドおよびそのオプションの詳細については、 CLI リファレンス: aspire initを参照してください。

`aspire init` は何を作成するのか？

aspire init を実行すると、ソリューションにはプロジェクトベースの AppHost が作成されます:

ExampleEcommerce.sln (updated)
ディレクトリsrc/
- ディレクトリExampleEcommerce.AppHost/ (new) orchestration project
  - ExampleEcommerce.AppHost.csproj project file
  - AppHost.cs orchestration code
- ディレクトリApi/
  - ExampleEcommerce.Api.csproj
  - Program.cs
  - ディレクトリControllers/
    …
- ディレクトリWeb/
  - ExampleEcommerce.Web.csproj
  - Program.cs
  - ディレクトリPages/
    …
- ディレクトリOrderProcessor/
  - ExampleEcommerce.OrderProcessor.csproj
  - Worker.cs

これは Web フロントエンド、API サービス、バックグラウンドワーカーを備えた典型的な e コマースソリューションの例です。

aspire init を実行すると、プロジェクトにはファイルベースの AppHost が作成されます:

ディレクトリmy-saas-app/
- apphost.cs (new) orchestration code
- apphost.run.json (new) configuration
- ディレクトリapi/
  - main.py
  - ディレクトリrouters/
    …
  - ディレクトリmodels/
    …
  - pyproject.toml
- ディレクトリfrontend/
  - app.py
  - ディレクトリtemplates/
    …
  - ディレクトリstatic/
    …
  - requirements.txt
- ディレクトリworker/
  - tasks.py
  - celery_config.py
  - requirements.txt

これは FastAPI バックエンド、Flask フロントエンド、Celery ワーカーを備えた典型的な SaaS アプリケーションの例です。

aspire init を実行すると、プロジェクトにはファイルベースの AppHost が作成されます:

ディレクトリmy-store/
- apphost.cs (new) orchestration code
- apphost.run.json (new) configuration
- ディレクトリpackages/
  - ディレクトリapi/
    ディレクトリsrc/
    server.js
    ディレクトリroutes/
    …
    package.json
  - ディレクトリweb/
    ディレクトリsrc/
    App.tsx
    ディレクトリcomponents/
    …
    package.json
    vite.config.ts
  - ディレクトリadmin/
    ディレクトリsrc/
    main.ts
    ディレクトリviews/
    …
    package.json
- package.json (workspace root)

これは Node.js API、React ストアフロント、管理ダッシュボードを備えた典型的なモノレポの例です。

新しく作成された AppHost プロジェクト内の AppHost.cs ファイルには、最初に次のような最小限のスターターコードが含まれています:

var builder = DistributedApplication.CreateBuilder(args);

// TODO: Add resources here

builder.Build().Run();

apphost.cs ファイルには、最初に次のような最小限のスターターコードが含まれています:

#:sdk Aspire.AppHost.Sdk@13.0.0

var builder = DistributedApplication.CreateBuilder(args);

// TODO: Add resources here

builder.Build().Run();

apphost.cs ファイルには、最初に次のような最小限のスターターコードが含まれています:

#:sdk Aspire.AppHost.Sdk@13.0.0

var builder = DistributedApplication.CreateBuilder(args);

// TODO: Add resources here

builder.Build().Run();

これは出発点となるコードです。次のセクションでは、既存のアプリケーションを追加し、それらの関係を構成していきます。

AppHost にアプリケーションを追加する

AppHost を用意したら、既存のアプリケーションを登録する必要があります。まず、アプリケーションの種類に応じたホスティングパッケージをインストールし、その後 AppHost にリソースを追加します。

ホスティングパッケージのインストール

C# プロジェクトで、プロジェクトベースのオーケストレーション (.csproj ファイル) を使用している場合、追加のパッケージは不要です。基本の Aspire SDK には、 AddProject<T> (またはファイルベースアプリ用の AddCSharpApp)のサポートが含まれています。

Python アプリケーションでは、Python 用のホスティングパッケージをインストールします。:

Aspire CLI
apphost.cs (C# file-based app)

aspire add python

Aspire CLI は対話的です。求められたら適切な結果を選択してください:

Select an integration to add:

> python (Aspire.Hosting.Python)
> Other results listed as selectable options...

#:package Aspire.Hosting.Python@*

このパッケージは、AddUvicornApp、AddPythonApp、AddPythonModule などのメソッドを提供します。

JavaScript / TypeScript アプリケーションの場合は、JavaScript 用のホスティングパッケージをインストールします:

Aspire CLI
apphost.cs (C# file-based app)

aspire add javascript

Aspire CLI は対話的です。求められたら適切な結果を選択してください:

Select an integration to add:

> javascript (Aspire.Hosting.JavaScript)
> Other results listed as selectable options...

#:package Aspire.Hosting.JavaScript@*

このパッケージは、AddViteApp、AddNodeApp、AddJavaScriptApp などのメソッドを提供します。

AppHost でリソースをモデル化する

AppHost プロジェクト内の AppHost.cs ファイルを更新し、アプリケーションをリソースとして登録します。リソースは分散アプリケーションの構成要素であり、各サービス、コンテナー、インフラストラクチャリソースは、Aspire がオーケストレーションできる対象になります。

apphost.cs ファイルを更新し、アプリケーションをリソースとして登録します。リソースは分散アプリケーションの構成要素であり、各サービス、コンテナー、インフラストラクチャリソースは、Aspire がオーケストレーションできる対象になります。

C# プロジェクトの場合は、AddProject を使用して既存の C# プロジェクトを参照します:

var builder = DistributedApplication.CreateBuilder(args);

var api = builder.AddProject<Projects.ExampleEcommerce_Api>("api")
    .WithHttpHealthCheck("/health");

var web = builder.AddProject<Projects.ExampleEcommerce_Web>("web")
    .WithExternalHttpEndpoints()
    .WithReference(api)
    .WaitFor(api);

var orderProcessor = builder.AddProject<Projects.ExampleEcommerce_OrderProcessor>("orderprocessor")
    .WithReference(api);

builder.Build().Run();

主なメソッド:

AddProject<T> - ソリューション内の .NET プロジェクトを追加します。
WithHttpHealthCheck - HTTP エンドポイントを通じてサービスの正常性を監視します。
WithReference - サービス間通信を有効にします。
WaitFor - 適切な起動順序を保証します。

Aspire では、Python アプリケーション向けにいくつかのメソッドが提供されています:

#:sdk Aspire.AppHost.Sdk@13.0.0
#:package Aspire.Hosting.Python@13.0.0

var builder = DistributedApplication.CreateBuilder(args);

// FastAPI backend
var api = builder.AddUvicornApp("api", "./api", "main:app")
    .WithUv()
    .WithHttpHealthCheck("/health");

// Flask frontend
var frontend = builder.AddUvicornApp("frontend", "./frontend", "app:app")
    .WithUv()
    .WithExternalHttpEndpoints()
    .WithReference(api)
    .WaitFor(api);

// Celery worker
var worker = builder.AddPythonApp("worker", "./worker", "celery")
    .WithUv()
    .WithArgs("worker", "-A", "tasks")
    .WithReference(api);

builder.Build().Run();

主なメソッド:

AddUvicornApp - FastAPI、Flask などの ASGI / WSGI フレームワーク向け。
AddPythonApp - 単体の Python スクリプト向け。
WithUv() - 高速なパッケージ管理のために uv を使用します。（推奨）
WithPip() - 従来の pip を使用したパッケージ管理。

JavaScript アプリケーションの場合は、アプリケーションの種類に応じて適切なメソッドを使用します:

#:sdk Aspire.AppHost.Sdk@13.0.0
#:package Aspire.Hosting.JavaScript@13.0.0

var builder = DistributedApplication.CreateBuilder(args);

// Node.js API
var api = builder.AddNodeApp("api", "./packages/api", "src/server.js")
    .WithNpm()
    .WithHttpHealthCheck("/health");

// React storefront
var web = builder.AddViteApp("web", "./packages/web")
    .WithExternalHttpEndpoints()
    .WithReference(api)
    .WaitFor(api);

// Admin dashboard
var admin = builder.AddViteApp("admin", "./packages/admin")
    .WithExternalHttpEndpoints()
    .WithReference(api)
    .WaitFor(api);

builder.Build().Run();

主なメソッド:

AddViteApp - Vite ベースのアプリケーション（React、Vue、Svelte など）向け。
AddNodeApp - Node.js アプリケーション向け。
AddJavaScriptApp -npm/yarn/pnpm を使用する汎用的な JavaScript アプリケーション向け
- WithNpm() / WithYarn() / WithPnpm() - 使用するパッケージマネージャーを指定
WithRunScript - 開発時に実行する npm スクリプトを指定

Aspire 9 で非推奨となった AddNpmApp API とは異なり、新しい JavaScript ホスティングメソッド（AddJavaScriptApp、AddViteApp、AddNodeApp）では、コンストラクターパラメーターとして args をサポートしていません。スクリプトに引数を渡す方法は次の 2 つがあります:

オプション 1: WithArgs を使用して直接引数を渡す

builder.AddViteApp("frontend", "./frontend")
    .WithArgs("--no-open");

オプション 2: 引数付きのカスタムスクリプトを package.json に定義する

{
  "scripts": {
    "dev": "vite",
    "dev:no-open": "vite --no-open"
  }
}

builder.AddViteApp("frontend", "./frontend")
    .WithRunScript("dev:no-open");

オプション 2 では、すべてのスクリプト設定を package.json にまとめられるため、スクリプトの見通しが良くなり、Aspire 以外でも（例: npm run dev:no-open）実行しやすくなります。

サービスを接続する

WithReference の呼び出しにより、サービス間の依存関係が確立され、サービス検出が有効になります:

// Omitted for brevity...

var api = builder.AddProject<Projects.YourApi>("api");

var web = builder.AddProject<Projects.YourWeb>("web")
    .WithReference(api);  // Web can call API

var worker = builder.AddProject<Projects.YourWorker>("worker")
    .WithReference(api);  // Worker can call API

// Omitted for brevity...

// Omitted for brevity...

var api = builder.AddUvicornApp("api", "../python-api", "main:app")
    .WithUv();

var worker = builder.AddPythonApp("worker", "../python-worker", "worker.py")
    .WithReference(api);  // Worker gets API_HTTP and API_HTTPS env vars

// Omitted for brevity...

// Omitted for brevity...

var api = builder.AddNodeApp("api", "../node-api", "server.js")
    .WithNpm();

var frontend = builder.AddViteApp("frontend", "../react-frontend")
    .WithReference(api);  // Frontend gets API_HTTP and API_HTTPS env vars

// Omitted for brevity...

WithReference を呼び出すことで、リソース間の依存関係を宣言します。あとは Aspire が自動的に処理し、ローカル実行時でも本番環境でも、サービス同士が円滑に通信できるように、実行時およびデプロイ時に必要な構成を自動で注入してくれます。

テレメトリ構成を追加する（任意）

ServiceDefaults は、.NET サービスに可観測性、回復性、正常性チェックを追加するための標準化された方法を提供します。この手順は任意ですが、本番アプリケーションでは推奨されます。

aspire init の実行中に、ServiceDefaults を追加するかどうかを確認される場合があります。最初に追加しなかった場合でも、後から Aspire CLI を使用するか、手動で追加できます。

ServiceDefaults を手動でプロジェクトに追加する:

dotnet new aspire-servicedefaults -n YourProject.ServiceDefaults
dotnet sln add YourProject.ServiceDefaults
dotnet add YourProject reference YourProject.ServiceDefaults

プロジェクトの Program.cs を更新して、ServiceDefaults を使用するようにする:

var builder = WebApplication.CreateBuilder(args);

// Add Aspire ServiceDefaults for observability and resilience
builder.AddServiceDefaults();

// ... your existing service configuration ...

var app = builder.Build();

// Map Aspire ServiceDefaults endpoints
app.MapDefaultEndpoints();

// ... your existing middleware ...

app.Run();

ServiceDefaults の詳細については、 Service Defaults を参照してください。

Python アプリケーションは、OpenTelemetry を使用して Aspire ダッシュボードにテレメトリを送信できます:

Python アプリケーションに OpenTelemetry パッケージをインストールします:

uv add opentelemetry-api opentelemetry-sdk opentelemetry-exporter-otlp-proto-grpc
uv add opentelemetry-instrumentation-fastapi  # For FastAPI
# Or for Flask:
# uv add opentelemetry-instrumentation-flask

Python アプリケーションで OpenTelemetry を構成します:

import os
from opentelemetry import trace, metrics
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.metrics import MeterProvider
from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter
from opentelemetry.exporter.otlp.proto.grpc.metric_exporter import OTLPMetricExporter
from opentelemetry.sdk.resources import Resource
from opentelemetry.instrumentation.fastapi import FastAPIInstrumentor

# Get OTLP endpoint from environment (injected by Aspire)
otlp_endpoint = os.getenv("OTEL_EXPORTER_OTLP_ENDPOINT")

# Configure tracing and metrics
resource = Resource.create({"service.name": "api"})
trace.set_tracer_provider(TracerProvider(resource=resource))
metrics.set_meter_provider(MeterProvider(resource=resource))

# Instrument your FastAPI app
FastAPIInstrumentor.instrument_app(app)

JavaScript / Node.js アプリケーションも、OpenTelemetry を使用してテレメトリを送信できます:

OpenTelemetry パッケージをインストールします:

npm install @opentelemetry/api @opentelemetry/sdk-node \
  @opentelemetry/auto-instrumentations-node \
  @opentelemetry/exporter-trace-otlp-grpc \
  @opentelemetry/exporter-metrics-otlp-grpc

テレメトリ構成ファイルを作成します:

const { NodeSDK } = require('@opentelemetry/sdk-node');
const {
  getNodeAutoInstrumentations,
} = require('@opentelemetry/auto-instrumentations-node');
const {
  OTLPTraceExporter,
} = require('@opentelemetry/exporter-trace-otlp-grpc');
const {
  OTLPMetricExporter,
} = require('@opentelemetry/exporter-metrics-otlp-grpc');
const {
  PeriodicExportingMetricReader,
} = require('@opentelemetry/sdk-metrics');
const { Resource } = require('@opentelemetry/resources');

const otlpEndpoint =
  process.env.OTEL_EXPORTER_OTLP_ENDPOINT || 'http://localhost:4317';

const sdk = new NodeSDK({
  resource: new Resource({ 'service.name': 'frontend' }),
  traceExporter: new OTLPTraceExporter({ url: otlpEndpoint }),
  metricReader: new PeriodicExportingMetricReader({
    exporter: new OTLPMetricExporter({ url: otlpEndpoint }),
  }),
  instrumentations: [getNodeAutoInstrumentations()],
});

sdk.start();

アプリケーションのエントリーポイントの先頭で、テレメトリ構成をインポートします:
JavaScript — app.js
```
// This must be first!
require('./telemetry');

const express = require('express');
// ... rest of your app
```

統合機能を追加する（任意）

Aspire には、Redis、PostgreSQL、RabbitMQ などの一般的なサービスを簡単に扱える統合ライブラリが用意されています。これらの統合機能は、構成、正常性チェック、テレメトリを自動的に処理します。

AppHost に Redis などのホスティング統合を追加し、それを依存するリソースから参照すると、Aspire は必要な構成を自動的に注入します。これには、接続文字列、URL、環境変数、その他サービス固有の設定が含まれ、サービス間での接続文字列の手動管理が不要になります。

アプリケーション内で Aspire の統合機能が有効に活用できるサービスを特定します。一般的な対象は次のとおりです:
- データベース（PostgreSQL、SQL Server、MongoDB）
- キャッシュ（Redis、Valkey）
- メッセージング（RabbitMQ、Azure Service Bus、Kafka）
- ストレージ（Azure Blob Storage、AWS S3）
aspire add コマンドを使用して、AppHost に統合パッケージを追加します:
Add a Redis integration
```
aspire add redis
```
このコマンドにより、必要な NuGet パッケージが追加され、統合の構成を支援します。

AppHost を更新して統合機能を参照し、すべてのサービス間で共有します。:

var builder = DistributedApplication.CreateBuilder(args);

// Add Redis resource
var cache = builder.AddRedis("cache");

// Share Redis with .NET API
var api = builder.AddProject<Projects.YourApi>("api")
    .WithReference(cache)
    .WithHttpHealthCheck("/health");

// Share Redis with Python worker
var pythonWorker = builder.AddPythonApp("worker", "../python-worker", "worker.py")
    .WithReference(cache);  // Python gets CACHE_HOST, CACHE_PORT env vars

// Share Redis with Node.js service
var nodeService = builder.AddNodeApp("service", "../node-service", "index.js")
    .WithReference(cache);  // Node.js gets CACHE_HOST, CACHE_PORT env vars

builder.Build().Run();

各開発言語で統合機能を構成します:

dotnet add YourApi package Aspire.StackExchange.Redis

var builder = WebApplication.CreateBuilder(args);
builder.AddRedisClient("cache");

uv add redis

import os
import redis

# Aspire injects CACHE_HOST and CACHE_PORT
redis_client = redis.Redis(
    host=os.getenv("CACHE_HOST"),
    port=int(os.getenv("CACHE_PORT")),
    decode_responses=True
)

npm install redis

const redis = require('redis');

// Aspire injects CACHE_HOST and CACHE_PORT
const client = redis.createClient({
  socket: {
    host: process.env.CACHE_HOST,
    port: process.env.CACHE_PORT,
  },
});

Integrations section で利用可能な統合機能を参照してください。

実行と確認

Aspire をアプリケーションに追加したので、実際に実行してオーケストレーションの動作を確認しましょう。

ソリューションディレクトリから、Aspire CLI を使用してアプリケーションを実行します:
Aspire でアプリケーションを実行
```
aspire run
```
Aspire CLI は次の処理を行います:
- AppHost（ファイルベースの apphost.cs）を検出する
- ソリューションをビルドする
- オーケストレーションされたすべてのサービスを起動する
- Aspire ダッシュボードを起動する

ダッシュボードの URL がターミナル出力に表示されます:

🔍  Finding apphosts...
apphost.cs

Dashboard:  https://localhost:17068/login?t=ea559845d54cea66b837dc0ff33c3bd3

     Logs:  ~/.aspire/cli/logs/apphost-13024-2025-11-19-12-00-00.log

            Press CTRL+C to stop the apphost and exit.

表示された URL を使用して、ブラウザーでダッシュボードを開きます。次の情報を確認できます:
- オーケストレーションされたすべてのリソースとその状態
- 各サービスのリアルタイムログ
- 可観測性のためのトレースとメトリクス
- 環境変数と構成情報
次の方法で、サービスが正しく動作していることを確認します:
- Resources ページでサービスの正常性を確認する
- アプリケーションのエンドポイントにアクセスする
- ダッシュボードでログやトレースを確認する
ターミナルで ⌘+C Control + C Control + C を押して、アプリケーションを停止します。

ボーナスコンテンツ

現在 Docker Compose を使用してサービスをオーケストレーションしている場合、Aspire はそれを置き換えることができ、さらに次のような追加のメリットを提供します。:

Docker compose の場合
Aspire の場合

1
services:
2
   postgres:
3
      image: postgres:latest
4
      environment:
5
         - POSTGRES_PASSWORD=postgres
6
         - POSTGRES_DB=mydb
7
      ports:
8
         - "5432:5432"
9

10
   api:
11
      build: ./api
12
      ports:
13
         - "8080:8080"
14
      environment:
15
         - DATABASE_URL=postgres://postgres:postgres@postgres:5432/mydb
16
      depends_on:
17
         - postgres
18

19
   web:
20
      build: ./web
21
      ports:
22
         - "3000:3000"
23
      environment:
24
         - API_URL=http://api:8080
25
      depends_on:
26
         - api

1
var builder = DistributedApplication.CreateBuilder(args);
2

3
var db = builder.AddPostgres("postgres")
4
.AddDatabase("mydb");
5

6
var api = builder.AddProject<Projects.Api>("api")
7
.WithReference(db);
8

9
var web = builder.AddProject<Projects.Web>("web")
10
.WithExternalHttpEndpoints()
11
.WithReference(api)
12
.WaitFor(api);
13

14
builder.Build().Run();

Docker Compose と比べた Aspire の主な利点:

記述量が圧倒的に少ない — それでいて、より表現力が高く強力。
URL の手動設定が不要 — サービス同士が自動的に相互発見する。
型安全な参照 — サービス依存関係をコンパイル時にチェック可能。
組み込みダッシュボード — Prometheus や Grafana などの追加ツールなしで可観測性を実現。
開発からデプロイまで一貫 — 同じオーケストレーションコードをローカル実行にも利用でき、Docker Compose の生成や任意の環境へのデプロイが可能。
統合ライブラリ — データベース、キャッシュ、メッセージキュー向けのベストプラクティスを組み込んだ事前構築済みサポート。
開発言語非依存 — C#、Python、JavaScript など多くの言語や、コンテナー化されたサービスに対応。

次のステップ

おめでとうございます！既存のアプリケーションに Aspire を正常に追加できました。次におすすめのステップは次のとおりです:

さらに統合機能を追加する — データベース、キャッシュ、メッセージキューの利用を簡素化するために、インテグレーションを確認してください
可観測性を構成する — アプリケーションのテレメトリを強化:
- Service Defaults を参照してください
- Standalone dashboard for Python を参照してください
- Standalone dashboard for Node.js を参照してください
アプリケーションをデプロイする — 最初のアプリをデプロイするチュートリアルに従って、Aspire アプリケーションをデプロイしてください
ダッシュボードを活用する — Aspire ダッシュボードとその機能について詳しく学びましょう
ポリグロット（多開発言語）機能について学ぶ:
- Aspire における Python サポート
- Aspire における JavaScript サポート

質問 & 回答コラボレーションコミュニティディスカッション視聴

既存のアプリを Aspireify する

既存のアプリに Aspire を追加する理由は？

事前準備

共通の要件

開発言語ごとの要件

プロセスの概要

Aspire 対応を初期化

aspire init は何を作成するのか？

AppHost にアプリケーションを追加する

ホスティング パッケージのインストール

AppHost でリソースをモデル化する

サービスを接続する

テレメトリ構成を追加する（任意）

統合機能を追加する（任意）

実行と確認

ボーナスコンテンツ

次のステップ

`aspire init` は何を作成するのか？

ホスティングパッケージのインストール