Aspire 13.2 の新機能

Aspire 13.2 へようこそ!長年の Aspire ユーザーでも、これから始めたばかりでも、新しい機能を試していただけることを楽しみにしています。質問やフィードバックがある場合、または問題に遭遇した場合は、Discord で挨拶するか、GitHub で issue を開いてください。

Aspire 13.2 では、CLI 機能の強化、ダッシュボードの改善、新しい AI エージェントの統合、多言語サポートの強化など、大幅な改善が行われています。このリリースは、Aspire の特徴である堅牢なクラウドネイティブ基盤を維持しながら、開発者とコーディングエージェントの両方にとってローカル開発をより合理化することに焦点を当てています。 13.2 には、Aspire チームがより頻繁に安定版リリースを出荷しやすくするための大幅なインフラストラクチャの改善も含まれています。このリリースの実現に貢献してくれたコミュニティの貢献者全員に多大な感謝を表します。皆さんの問題、PR、フィードバックが Aspire の前進の原動力となります。

🆙 Aspire 13.2 にアップグレードする

一般的なアップグレードのガイダンスについては、Upgrade Aspire を参照してください。

Aspire 13.2 にアップグレードする最も簡単な方法は、aspire update コマンドを使用することです。

Aspire CLI を更新します。
Aspire CLI — CLI を更新する
```
aspire update --self
```
aspire update コマンドを使用して、Aspire アプリホストを更新します。
Aspire CLI — すべての Aspire パッケージを更新
```
aspire update
```

または、CLI を最初からインストールします。

Bash
PowerShell

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

irm https://aspire.dev/install.ps1 | iex

Aspire バージョン 13.2.0 を参照するようにアプリホストを手動で更新することもできます。

C# AppHost

#:package Aspire.AppHost.Sdk@13.2.0

C# アプリホストを使用している場合は、NuGet 経由でホスティングとクライアントの統合の両方をアップグレードできます。

TypeScript アプリホストを使用している場合は、アップグレード後に aspire restore を実行して、統合 SDK が再生成されるようにします。

Aspire CLI のインストールの詳細については、Aspire CLI のインストールを参照してください。

🛠️ CLI の機能強化

Aspire 13.2 では、ターミナルからできることを劇的に拡張する新しい CLI コマンドが導入されています。 CLI は、これまでダッシュボードとアプリホスト内に閉じ込められていたすべてのデータを公開し、スクリプト、エディター、自動化ワークフローからアクセスできるようになりました。

言語固有のテンプレートと複数言語のセットアップ

Aspire 13.2 では、aspire new (完全なスターターテンプレートを作成) および aspire init (アプリホストのみを作成) のエクスペリエンスが、より言語を意識したものになります。 CLI には、C#、TypeScript、Python、および C# と TypeScript の両方のアプリホスト向けの言語固有のフルスタックスターターアプリをスキャフォールディングするオプションが追加されました。 aspire new を使用してテンプレートから新しいプロジェクトを作成するか、aspire init を使用して既存のプロジェクトに Aspire を追加します。

新しい aspire restore コマンドは、このワークフローを補完します。 C# アプリホストの場合は統合 NuGet パッケージを復元し、TypeScript アプリホストの場合は統合 SDK コードと必要なアーティファクトを再生成します。これは aspire run で自動的に行われますが、手動でも公開されるようになりました。

# インタラクティブなテンプレート ピッカーを使用して新しいスターターを作成する
aspire new

# または、既存のコードベースに新しい空の apphost を作成します。
aspire init

# 統合パッケージを復元し、アプリホストを起動します
aspire run

# 統合を手動で復元する
aspire restore

分離モードとプロセス管理

最もリクエストの多かった機能の 1 つが 13.2 に登場しました。Aspire 化したアプリを実行する デタッチモード です。バックグラウンドで apphost を実行できるようになり、端末を他のタスクのために解放できるようになりました。

# 分離モードで実行する
aspire run --detach

# run --detach の短縮コマンド
aspire start

# 実行中のすべてのアプリホストをリストする
aspire ps

# バックグラウンドで実行中のアプリホストを停止する
aspire stop

aspire ps コマンドを使用すると、現在実行中のすべての Aspire アプリホストが表示されるため、複数のプロジェクトを同時に管理することが簡単になります。 aspire stop と組み合わせると、コマンドラインから直接アプリケーションのライフサイクルを完全に制御できます。

新しい aspire start ショートカットにより、アプリホストのバックグラウンド起動が覚えやすくなり、aspire stop により、選択したアプリホストまたは実行中のすべてのアプリホストを停止できます。 JSON モードでは、aspire ps にリソースを含めることができるため、自動化とエディターの統合のための強固な構成要素になります。

aspire start --apphost .\MyApp.AppHost\MyApp.AppHost.csproj
aspire ps --resources --format json
aspire stop --all

リソースコマンドも aspire resource <resource> <command> 形式に再編成されました。 start、stop、restart などの組み込みコマンドが、ダッシュボードで公開される内容とより自然に連携するようになり、プロジェクトリソースで rebuild などのより豊富なコマンドを公開できるようになりました。

aspire resource api restart
aspire resource api rebuild

自動化および CI/CD シナリオの場合、--format Json を使用して機械可読出力を取得します。

aspire run --detach --format Json
aspire ps --format Json

コマンドリファレンス: aspire run、 aspire ps および aspire stop。

並列開発のための分離モード

新しい --isolated フラグは、ランダム化されたポートと分離されたユーザーシークレットを使用してアプリホストを実行し、ポートの競合や構成の衝突を防ぎます。

aspire run --isolated
aspire start --isolated

これは、同じアプリホストの複数のインスタンスを並行して実行する必要があるエージェントワークフロー、git ワークツリー、統合テストで特に役立ちます。

`aspire describe` によるリソース監視

新しい aspire describe コマンドを使用すると、ユーザーとコーディングエージェントは、Aspire ダッシュボードで取得するのと同じ詳細なリソース情報に CLI アクセスできるようになります。リソースの状態、構成、環境変数、健全性ステータスなどをすべてターミナルから検査できます。

# 実行中のアプリホスト内のすべてのリソースを表示する
aspire describe

# リソース状態の変化を継続的にストリーミングする
aspire describe --follow

コマンドリファレンス: aspire describe。

`aspire doctor` による環境診断

新しい aspire doctor コマンドは、開発環境の包括的な診断を提供します。

aspire doctor

このコマンドは以下をチェックします。

HTTPS 開発証明書のステータス（複数の証明書の検出を含む）
コンテナランタイム (Docker/Podman) の可用性とバージョン
Docker エンジンのコンテナトンネル要件
.NET SDK のインストールとバージョン
WSL2 環境設定
エージェント構成ステータス (非推奨の設定の検出)

すべての実行ですべてのチェックが表示されるわけではありません。 WSL2 構成やエージェント構成ステータスなどの一部のチェックは条件付きであり、関連する環境または問題が検出された場合にのみ表示されます。

問題が検出された場合、出力には実用的な推奨事項が表示されるため、構成の問題のトラブルシューティングが容易になります。

あいまい検索による `aspire add` の強化

aspire add コマンドのあいまい検索により、適切な統合パッケージを簡単に見つけることができるようになりました。入力を開始するだけで、CLI が一致するパッケージを提案し、新しい統合を見つけてプロジェクトに追加する手間が軽減されます。このリリースでは、フレンドリ名の生成も改善され、C# アプリの NuGet 集中パッケージ管理がより適切に尊重されます。

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

証明書、エクスポート、シークレット、リソースのライフサイクル用の新しい CLI コマンド

Aspire 13.2 では、いくつかの新しいコマンドにより、日常的な CLI の対象領域が大幅に拡張されています。

証明書とパラメータ/シークレット管理は、ファーストクラスのコマンドを取得します。

aspire certs clean
aspire certs trust

aspire secret set ApiKey super-secret-value
aspire secret list --format json

aspire certs は、古い開発者証明書をクリーンアップし、現在の証明書を信頼するのに役立ちます。一方、aspire secret は、アプリホストユーザーシークレットに、シークレット値の設定、読み取り、一覧表示、検索、および削除のための独自の専用 CLI ワークフローを提供します。これらは、アプリモデルで AddParameter(..., secret: true) 呼び出しをサポートするシークレット値と同じです。aspire secret set はユーザーシークレットストアに書き込むため、dotnet user-secrets 経由で管理するために .NET CLI をインストールする必要はなくなります。

2 つの新しい操作コマンドがエクスペリエンスを完成させます。

aspire wait api --status healthy --timeout 120
aspire export --output .\artifacts\aspire-export.zip

aspire wait を使用して、リソースが healthy、up、または down になるまで自動化をブロックし、aspire export を使用して、実行中のアプリホストからテレメトリデータとリソースデータを zip ファイルにキャプチャします。 aspire export <resource> を使用して、エクスポートの範囲を単一のリソースに設定することもできます。

パラメーターとシークレットの詳細については、「外部パラメーター」を参照してください。コマンドリファレンス: aspire secret。

エージェントの統合 (`aspire agent`)

AI エージェントの統合を管理するという目的をより適切に反映するために、aspire mcp コマンドの名前が aspire agent に変更されました。また、Aspire 固有の SKILL.md ファイルをリポジトリに追加するように更新されました。新しいコマンド構造には次のものが含まれます。

# MCP やスキルを含むエージェント環境設定を初期化します。
aspire agent init

# MCP (Model Context Protocol) サーバーを手動で起動する - のみ
aspire agent mcp

これにより、AI エージェントが標準化されたプロトコルを通じて Aspire アプリケーションと対話できるようになり、AI 支援開発ワークフローの新たな可能性が開かれます。

コマンドリファレンス: aspire agent、aspire agent mcp、および aspire agent init。

Aspire で AI エージェントを構成する方法については、AI コーディングエージェントの使用を参照してください。

CLI からのドキュメントコマンド (`aspire docs`)

新しい aspire docs コマンドは、公式の aspire.dev ドキュメントをターミナルに直接取り込みます。Aspire エージェントの統合を強化する同じ MCP (モデルコンテキストプロトコル) ドキュメントツール上に構築されています。これらのコマンドを使用すると、開発ワークフローを離れることなくドキュメントを参照、検索、および読むことができます。

# 利用可能なドキュメント ページをすべてリストします。
aspire docs list

# 特定のトピックを検索する
aspire docs search "redis"

# スラグごとに完全なドキュメント ページを読む
aspire docs get redis-integration

# ページの特定のセクションを読む
aspire docs get redis-integration --section "Add Redis resource"

各コマンドは機械可読出力の --format Json をサポートしているため、スクリプト作成や自動化に役立ちます。 aspire docs search コマンドは、返される結果の数を制御する --limit オプションも受け入れます。

コマンドリファレンス: aspire docs、 aspire docs list, aspire docs search, and aspire docs get。

構成管理の改善

aspire config コマンドが強化され、より適切に構成されました。

# すべての構成をセクションと色で整理してリストします。
aspire config list

# 利用可能な機能フラグをすべてリストします。
aspire config list --all

# 特定の設定を取得する
aspire config get <key>

# 構成値を設定する
aspire config set <key> <value>

構成がローカル設定とグローバル設定に明確に分離され、機能フラグが整理されて表示されるようになりました。

Aspire は、アプリホストの場所、言語メタデータ、Aspire SDK バージョン、チャネル選択、機能フラグ、起動プロファイル、パッケージピンを組み合わせた単一の aspire.config.json ファイルを優先するようになりました。

{
  "appHost": {
    "path": "apphost.ts",
    "language": "typescript/nodejs"
  },
  "sdk": {
    "version": "13.2.0"
  },
  "channel": "stable",
  "profiles": {
    "default": {
      "applicationUrl": "https://localhost:17000;http://localhost:15000"
    }
  }
}

この統一された形式は、.aspire/settings.json と apphost.run.json にまたがる古い分割を置き換え、TypeScript アプリホストの移動、検査、自動化をはるかに簡単にします。

従来の構成ファイルからの自動移行

.aspire/settings.json または apphost.run.json を使用する既存のプロジェクトがある場合、CLI は移行を自動的に処理します。既存のプロジェクトに対して aspire コマンド (aspire run など) を初めて実行すると、CLI は従来の .aspire/settings.json と apphost.run.json をプロジェクトルートで新しい aspire.config.json にマージします。パスは自動的に再ベースされます。たとえば、.aspire/ ディレクトリに相対していた appHostPath は、プロジェクトルートに相対するように調整されます。レガシーファイルは移行中に保存されるため、必要に応じて古い CLI バージョンを並行して使用し続けることができます。

グローバル設定 (ユーザーレベルの Aspire ディレクトリ内の globalsettings.json) も、同じ場所の新しい aspire.config.json 形式にコピーされます。手動の手順は必要ありません。CLI を更新して、通常どおりプロジェクトを実行するだけです。

コマンドリファレンス: aspire config、 aspire config list, aspire config get, and aspire config set。

CLI オプションの標準化

一般的な CLI 規則との一貫性を保つために、いくつかの CLI オプションが標準化されました。

-v (--version 用): -v フラグは、標準の CLI 規則に従って、--version の短いエイリアスになりました。
--format の説明: --format オプションの説明が「出力形式 (Table または Json)」に標準化されました。それをサポートするすべてのコマンドにわたって。
--log-level/-l: ログレベルのフィルタリングをサポートするコマンドは、一貫して --log-level/-l を使用するようになりました。

その他の CLI の改善

13.2 には、小さいながらも有意義な CLI の改善が数多くあります。

apphost アーティファクトがすでに最新であることがわかっている場合、aspire run は --no-build をサポートするようになりました。
--format json は常に JSON 出力を stdout に送信し、ステータスメッセージは stderr に送信されます。これにより、人間が判読できる出力が構造化された JSON 出力から分離された状態に保たれるため、JSON を使用するスクリプトやエディターが整形式のコンテンツを受信できるようになります。
テーブル、ステータスインジケーター、ヘルプ構成、ログ、およびエラーメッセージが、対話型シナリオと非対話型シナリオにわたって改良されました。
統合された自己解凍型 Aspire CLI バンドルにより、特に .NET がまだグローバルにインストールされていない場合の多言語エクスペリエンスが向上し続けます。
絵文字で始まるステータスメッセージは一貫して配置されます。これはあなたが思っているよりも難しいです！乱雑な CLI 出力が表示された場合は、お知らせください.

🧩 VS コード拡張機能

Aspire VS Code 拡張機能は 13.2 でこれまでで最大のアップデートを受け、20 以上の PR が新機能を提供し、VS Code を Visual Studio と並ぶ一流の Aspire 開発環境にしました。

Aspire アクティビティバーパネル

アクティビティバーの専用 Aspire パネルでは、実行中のアプリホストとそのリソースのライブツリービューが表示されます。パネルは aspire describe --follow を使用して、ワークスペースアプリホストのリアルタイムのリソース状態更新をストリーミングします (ポーリングや待ち時間はありません)。ワークスペース/グローバル切り替えを使用すると、現在のワークスペースのアプリホストのみを表示するか、マシン上で実行中のすべてのアプリホストを表示するかを切り替えることができます。

ツリー内のリソースには、健全性を認識するアイコン (正常な場合は緑色、エラーは赤色、劣化した場合はオレンジ色、起動中の場合はスピナー)、タイプ、状態、クリック可能なエンドポイント URL を含む豊富なマークダウンツールチップ、およびログの表示、リソースの停止、再起動などの一般的な操作のための右クリックのコンテキストメニューが表示されます。

CodeLens とガターの装飾

Aspire アプリホストが実行されている場合、拡張機能は C# または TypeScript アプリホストファイルの各リソース定義の上に インライン CodeLens を表示するようになりました。

リソースのライブ状態 (実行中、開始中、停止、エラー) と健全性ステータス
アクションボタン: 開始、停止、再起動、ログの表示
ランタイムからのカスタムリソースコマンド

色付きの ガター装飾 がリソース定義の横に表示されます (実行中は緑、開始中は青、エラーは赤、停止中は灰色)。エディターでアプリ全体の健全性を一目で確認できます。どちらの機能も、C# の DistributedApplication.CreateBuilder と TypeScript の createBuilder() を理解する言語対応パーサーによってサポートされています。

スタートガイドのチュートリアル

新しい 「はじめに」ウォークスルー では、CLI のインストール、プロジェクトの作成、アプリの実行、ダッシュボードの探索、および次のステップをすべて VS Code 内から行うことができるように、新規ユーザーをガイドします。このウォークスルーには、エディターから直接 Aspire CLI をインストールするためのクリック可能なターミナルリンクが含まれています。

デバッグの改善

Azure Functions のデバッグ — アプリホストから参照される Azure Functions プロジェクトを直接デバッグできるようになりました。
TypeScript アプリホストのデバッグ - TS アプリホストは、ツールの検出、ビルド/起動の調整、ブラウザーのデバッグシナリオのサポートの向上により、より自然にデバッグに参加できるようになりました。
publish、deploy、do フロー を拡張機能から直接デバッグできるようになりました。
Apphost 終了メッセージ がデバッグコンソールに表示され、トラブルシューティングが容易になりました。

`aspire.config.json` および MCP のサポート

この拡張機能は、.csproj ファイル検出のみに依存するのではなく、アプリホスト検出のために aspire.config.json を読み取るようになり、TypeScript アプリホストがシームレスに機能するようになりました。 AI エージェントワークフロー用に Aspire MCP サーバーを自動登録することもできます。 CLI は、PATH 上にない場合でも、デフォルトのインストールパスで自動的に検出されます。

追加の改善点

新しい enableAspireDashboardAutoLaunch 設定により、実行時のダッシュボードの自動起動を無効にできます。
ファイルピッカーは、より多くの場所で生の文字列プロンプトを置き換えます。
リソースエンドポイント URL を右クリックしてコンテキストメニューを表示します。
code が見つからない場合は、code-insiders に戻ります。

詳細については、Aspire で VS Code を使用するおよび VS Code Marketplace の拡張機能を参照してください。

🌐 TypeScript AppHost のサポート (プレビュー)

Aspire 13.2 で最も期待されている機能の 1 つは、TypeScript でのアプリホストの作成のサポートです。 TypeScript AppHost は現在プレビュー段階です。

TypeScript で apphost を書く

TypeScript アプリホストは、createBuilder() を介して慣用的な TypeScript で表現された C# と同じアプリモデル (リソース、参照、統合) を使用します。

import { 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder } from './.modules/aspire.js';

const 
const builder: IDistributedApplicationBuilder
builder = await 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder();

const 
const cache: RedisResource
cache = await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addRedis(name: string, options?: {
    port?: number;
    password?: string | ParameterResource;
}): RedisResource (+1 overload)
Adds a Redis container resource
addRedis("cache");
const 
const api: ProjectResource
api = await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addProject(name: string, projectPath: string, options?: {
    launchProfileOrOptions?: ProjectResourceOptions;
}): ProjectResource (+1 overload)
Adds a .NET project resource
addProject("api", "../api")
    .
ProjectResource.withReference(source: EndpointReference | string | uri, options?: {
    connectionName?: string;
    optional?: boolean;
    name?: string;
} | undefined): ProjectResource (+2 overloads)
Adds a reference to another resource
withReference(
const cache: RedisResource
cache)
    .
ProjectResource.waitFor(dependency: IResource, waitBehavior?: WaitBehavior): ProjectResource
Waits for another resource to be ready
waitFor(
const cache: RedisResource
cache);

await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.build(): DistributedApplication
Builds the distributed application
build().
DistributedApplication.run(cancellationToken?: cancellationToken): void
Runs the distributed application
run();

内部では、これは Aspire の .NET オーケストレーションホストと並行してゲストプロセスとして実行され、ローカルトランスポート経由で JSON-RPC 経由で通信します。 TypeScript はリソースグラフを定義します。ホストはオーケストレーション、ヘルスチェック、ダッシュボードを処理します。

コード生成

aspire add を実行すると、CLI は統合の .NET アセンブリを検査し、TypeScript SDK を .modules/ に生成します。 aspire restore を実行すると、これらの SDK が再生成されます。これは、ブランチのアップグレードまたは切り替え後に役立ちます (これは、aspire run でも自動的に実行されます)。

13.2 では、コードジェネレーターは、より豊富なコレクション処理のための AspireList サポートを取得し、TypeScript とともに Go、Java、および Rust のテストターゲットをカバーするようになりました。

デバッグ、ツール、およびテンプレート

TypeScript アプリホストは、VS Code 拡張機能で最上級のサポートを備えています。CodeLens、ガター装飾、デバッグはすべて createBuilder() 呼び出しで機能します。 aspire.config.json 形式は、.csproj を必要とせずに TypeScript アプリホストが自動的に検出されることを意味します。テンプレートも更新され、依存関係が更新され、スターターのデフォルトが改善されました。

詳細については、多言語対応アーキテクチャをご覧ください。

📊 ダッシュボードの改善

データのエクスポートとインポート

Aspire 13.2 では、ダッシュボードに包括的なデータのエクスポートおよびインポート機能が追加されています。一元化されたダイアログを通じてテレメトリを一括管理したり、個々のリソースとテレメトリを JSON としてエクスポートしたり、環境変数を .env ファイルとしてエクスポートしたりできます。

「ログとテレメトリの管理」ダイアログ

新しい ログとテレメトリの管理 ダイアログ (設定 → 管理 からアクセス可能) は、ダッシュボードからデータをエクスポート、インポート、削除するためのワンストップショップです。リソースとテレメトリタイプを選択し、必要に応じてエクスポート、削除、またはインポートします。

データは zip ファイル内の JSON としてエクスポートされます。 AI やチームメイトと共有したり、後でダッシュボードにインポートし直したりできます。

[選択したものをエクスポート]、[選択したものを削除]、および [ログとテレメトリのインポート] ボタンが表示されたログとテレメトリの管理ダイアログ

ダッシュボードでは、aspire export でキャプチャされたテレメトリバンドルをインポートすることもできるため、診断をバグレポートに添付したり、セッションの特定時点のビューを保存したり、失敗したシナリオをチームメイトと共有したりすることが簡単になります。

リソースとテレメトリの JSON をエクスポートする

特定のリソースとテレメトリのデータをダッシュボードから直接エクスポートします。コンテキストメニューで Export JSON を選択してデータを取得します。データをクリップボードにコピーするか、マシンにダウンロードします。

クリップボードにコピーするかダウンロードするオプションを含む「JSON をエクスポート」ダイアログ

環境変数を `.env` ファイルとしてエクスポートする

リソースの詳細ビューからリソースの環境変数を .env ファイル形式に直接エクスポートします。

.env 形式でエクスポートされた環境変数を示す「環境のエクスポート」ダイアログ

テレメトリ HTTP API

ダッシュボードは、テレメトリデータをプログラムでクエリするための HTTP API を公開するようになりました。これらの API は、aspire agent mcp および aspire otel Aspire CLI コマンドを強化します。

API は /api/telemetry で提供され、OTLP JSON 形式でデータを返します。利用可能なエンドポイント:

GET /api/telemetry/resources — テレメトリデータを持つリソースをリストします。
GET /api/telemetry/spans — オプションのフィルターを使用したクエリスパン
GET /api/telemetry/logs — オプションのフィルターを使用してログをクエリする
GET /api/telemetry/traces — オプションのフィルターを使用してトレースをリストします。
GET /api/telemetry/traces/{traceId} — 特定のトレースのすべてのスパンを取得します

スパンとログのエンドポイントは、?follow=true を介したリアルタイムストリーミングもサポートしており、新しいテレメトリが到着すると NDJSON (改行区切りの JSON) を返します。 resource クエリパラメーター (例: ?resource=api&resource=worker) を繰り返すことで、複数のリソース名を指定できます。

Aspire アプリホストで実行すると、テレメトリ API が自動的に有効になります。スタンドアロンダッシュボード展開の場合は、DASHBOARD__API__ENABLED 環境変数を true に設定し、DASHBOARD__API__AUTHMODE (ApiKey または Unsecured) および DASHBOARD__API__PRIMARYAPIKEY を使用して認証を構成します。

ダッシュボードからパラメータを設定する

ダッシュボードでリソースパラメータを直接設定できるようになりました。パラメータのキーアクションをクリックし、新しい値を入力します。次回それを覚えておくために、オプションで値をユーザーシークレットに保存します。

ユーザーシークレットに保存するオプションを使用してパラメーター値を設定するためのダッシュボードダイアログ

GenAI ビジュアライザーの改善

GenAI ビジュアライザーはますます鮮明になっています。 13.2 では、より多くのスキーマ形状を処理し、切り捨てられたペイロードをより適切に許容し、非 ASCII テキストを適切に表示し、ツール呼び出しから対応するツール定義に直接ジャンプできるようにすることでツールの検査を容易にします。

リソースグラフの改善

リソースグラフのレイアウトは、適応力に基づく配置により大幅に改善されました。多くの接続を持つリソースの周囲にスペースができるようになり、複雑なグラフが乱雑に感じられなくなりました。

改善後：

ダッシュボードの UX の改良

13.2 でのダッシュボードの追加の改良点:

リソースの永続的な折りたたみ/展開状態
12 時間または 24 時間形式の設定。
ダッシュボードと CLI 全体で一貫したリソースの色。
トレース、スパン、ログ、リソースの JSON ビューアが改善されました。
大きな gRPC ペイロードの処理が改善されました。
グラフのレイアウトとフィルタリング動作がより安定しました。
リバースプロキシシナリオのベースパス構成。
レプリカ状態の集約 - 親リソースは、レプリカからの結合された状態を表示するようになりました。
より洗練されたダイアログ、メニュー、コピーフロー、およびリソースの詳細ビュー。

詳細については、 Aspire ダッシュボードを探索するおよびダッシュボード構成。

🧩 アプリモデルとリソースの改善

アプリモデルからの MCP エンドポイント

Aspire 13.2 には WithMcpServer が追加されており、リソースが Model Context Protocol (MCP) サーバーをホストすることをアプリモデル内で宣言できます。 Aspire ツールは、そのエンドポイントを直接検出してプロキシすることができます。

C# AppHost
TypeScript AppHost

var builder = DistributedApplication.CreateBuilder(args);

var api = builder.AddProject<Projects.MyApi>("api")
    .WithMcpServer("/mcp");

builder.Build().Run();

import { 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder } from './.modules/aspire.js';

const 
const builder: IDistributedApplicationBuilder
builder = await 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder();

const 
const api: ProjectResource
api = await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addProject(name: string, projectPath: string, options?: {
    launchProfileOrOptions?: ProjectResourceOptions;
}): ProjectResource (+1 overload)
Adds a .NET project resource
addProject("api", "../api")
    .
ProjectResource.withMcpServer(options?: {
    path?: string;
    endpointName?: string;
} | undefined): ProjectResource (+1 overload)
Configures an MCP server endpoint on the resource
withMcpServer({ 
path?: string | undefined
path: "/mcp" });

await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.build(): DistributedApplication
Builds the distributed application
build().
DistributedApplication.run(cancellationToken?: cancellationToken): void
Runs the distributed application
run();

プロジェクトの再構築とよりスマートな変更検出

.NET プロジェクトリソースは、通常のライフサイクルコマンドに加えて rebuild コマンドをサポートするようになりました。これにより、apphost セッション全体を破棄することなく、単一のプロジェクトリソースにソースの変更を適用するクリーンな方法が得られます。

aspire resource api rebuild

内部では、Aspire は、隠されたリビルドリソースと改善された変更検出を通じて、停止、構築、再起動を調整します。そのため、そのエクスペリエンスは、「すべてを再起動して希望を得る」というよりは、「これだけを再構築する」にはるかに近くなります。

ファーストクラスのリソースとしての OTLP エンドポイント

OpenTelemetry Protocol (OTLP) エンドポイントは、アプリケーションモデルのファーストクラスリソースとしてモデル化され、ダッシュボードに表示され、標準リソース API を通じて構成できるようになりました。

シークレットと証明書の処理の改善

13.2 では、コンテナービルドシークレットの API がより明確になりました。 WithBuildSecret は古い WithSecretBuildArg 名を置き換え、安全な Docker または Podman ビルドのシークレットフローを読みやすくします。

C# AppHost
TypeScript AppHost

var builder = DistributedApplication.CreateBuilder(args);

var accessToken = builder.AddParameter("accessToken", secret: true);

builder.AddContainer("worker", "contoso/worker")
    .WithDockerfile("../worker")
    .WithBuildSecret("ACCESS_TOKEN", accessToken);

import { 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder } from './.modules/aspire.js';

const 
const builder: IDistributedApplicationBuilder
builder = await 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder();

const 
const accessToken: ParameterResource
accessToken = await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addParameter(name: string, options?: {
    value?: string;
    publishValueAsDefault?: boolean;
    secret?: boolean;
}): ParameterResource (+1 overload)
Adds a parameter resource
addParameter("accessToken", { 
secret?: boolean | undefined
secret: true });

await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addContainer(name: string, image: AddContainerOptions): ContainerResource
Adds a container resource
addContainer("worker", { 
AddContainerOptions.image: string
image: "contoso/worker", 
AddContainerOptions.tag: string
tag: "latest" })
    .
ContainerResource.withDockerfile(contextPath: string, options?: {
    dockerfilePath?: string;
    stage?: string;
} | undefined): ContainerResource (+1 overload)
Configures the resource to use a Dockerfile
withDockerfile("../worker")
    .
ContainerResource.withBuildSecret(name: string, value: string | ParameterResource): ContainerResource
Adds a build secret from a parameter resource
withBuildSecret("ACCESS_TOKEN", 
const accessToken: ParameterResource
accessToken);

証明書の信頼処理もより柔軟になりました。実行モード中にカスタム証明書バンドルを作成できるようになりました。これは、デフォルトの証明書レイアウトにきれいにマップされない Java トラストストアやカスタムバンドル形式などのシナリオに役立ちます。

builder.AddContainer("my-java-app", "my-image:latest")
    .WithCertificateTrustConfiguration(ctx =>
    {
        ctx.EnvironmentVariables["JAVAX_NET_SSL_TRUSTSTORE"] =
            ctx.CreateCustomBundle((certs, ct) =>
        {
            var pkcs12Builder = new Pkcs12Builder();
            var safeContents = new Pkcs12SafeContents();

            foreach (var cert in certs)
            {
                safeContents.AddCertificate(cert);
            }

            pkcs12Builder.AddSafeContentsUnencrypted(safeContents);
            pkcs12Builder.SealWithMac(
                string.Empty, HashAlgorithmName.SHA256, 2048);

            return Task.FromResult(pkcs12Builder.Encode());
        });

        return Task.CompletedTask;
    });

ReferenceExpression は GetValueAsync() を公開し、多言語コード生成で条件付きモードをサポートするようになりました。これにより、同期値アクセスパターンに依存せずに高度なホスティング拡張機能を簡単に構築できるようになります。

強化されたデバッグエクスペリエンス

デバッグを改善するために、いくつかの型に DebuggerDisplayAttribute が含まれるようになりました。

DistributedApplication
リソースの種類
EndpointReferenceExpression
ReferenceExpression
PipelineStep

これにより、デバッグセッション中に Aspire アプリケーションの状態を検査することが容易になります。

リソースイベントの改善

ロギングコンテキストを改善するために、Logger プロパティを IDistributedApplicationResourceEvent に追加しました
ResourceNotificationService.WaitFor 例外メッセージが改善され、より詳細な情報が追加されました
BeforeResourceStartedEvent は実際にリソースを開始するときにのみ起動するようになりました (破壊的な変更)

イベントの詳細については、 AppHost eventing APIを参照してください。

Docker とコンテナの機能強化

プル「しない」ポリシー: ローカルイメージを必要とするシナリオ向けの公開イメージプルポリシーオプション
Docker Compose の PullPolicy: Docker Compose サービスクラスに PullPolicy プロパティを追加しました
ファイルベースの Docker ビルドシークレット: ビルドシークレットをファイル (.npmrc など) にできるようになり、資格情報をイメージにベイクすることなく、コンテナービルドでプライベートレジストリ認証が可能になります。
PostgreSQL v18+ 互換性: PostgreSQL バージョン 18 以降のデータボリュームパスを修正しました

ビルドの改善

apphost プロジェクトで GenerateAssemblyInfo が無効になっている場合のビルドエラー
launchSettings.json で末尾のカンマが許可されるようになりました
JSON コメントと末尾のカンマはエラーなしで解析されました

コンテキストに応じたエンドポイント解決

Aspire 13.2 では、特定のリソースまたはネットワークの観点からエンドポイントを解決できる、強化されたコンテキストエンドポイント解決 API が導入されています。これにより、コンテナー、ホストサービス、特定のネットワークなど、アクセス元に応じてリソースの正しい URL を取得できます。

同じリソースは、コンテキストに応じて異なる URL を持つことができます。

ローカルホストから: http://localhost:1234
ホスト Docker ネットワーク上のコンテナから: http://host.docker.internal:1234
Aspire コンテナネットワーク上のコンテナから: http://resource.dev.internal:4567

特定のリソース (呼び出し元) から解決します。

ValueProviderContext の Caller プロパティを使用して、特定の呼び出しリソースの観点からエンドポイント URL を解決できます。

var builder = DistributedApplication.CreateBuilder(args);

var redis = builder.AddRedis("cache");
var containerApp = builder.AddContainer("worker", "myimage");

// エンドポイント参照を取得する
var endpoint = redis.GetEndpoint("tcp");

// コンテナの観点から URL を解決する
var url = await endpoint.GetValueAsync(new ValueProviderContext {
    Caller = containerApp.Resource,
});

// URL はコンテナ間の通信に適したものになります。
// 例: "redis:6379" または "cache:6379"

これは、異なるコンテキスト (コンテナーとホストプロセス) で実行されている可能性のあるリソース間で接続情報を渡す必要がある場合に特に便利です。

特定のネットワークから解決する

ValueProviderContext の Network プロパティを使用して、特定のネットワークの観点からエンドポイント URL を解決することもできます。

var builder = DistributedApplication.CreateBuilder(args);

var redis = builder.AddRedis("cache");

// エンドポイント参照を取得する
var endpoint = redis.GetEndpoint("tcp");

// デフォルトの Aspire コンテナ ネットワークの URL を解決します。
var url = await endpoint.GetValueAsync(new ValueProviderContext {
    Network = KnownNetworkIdentifiers.DefaultAspireContainerNetwork
});

// URL はコンテナ ネットワークに適したものになります
// 例: リソース名をホスト名として使用する「cache:6379」

KnownNetworkIdentifiers クラスは、事前定義されたネットワーク識別子を提供します。

LocalhostNetwork: ローカルホストベースの URL に解決されます。
DefaultAspireContainerNetwork: リソース名を使用してコンテナーネットワーク URL に解決します
PublicInternet: 外部からアクセス可能な URL に解決されます。

詳細については、次を参照してください: - GitHub の問題 #7153 - GitHub PR #14278 - コンテキストベースのエンドポイント解決

📦 統合のアップデート

Docker Compose の公開

Aspire 13.2 では、Docker Compose 公開統合がプレリリースから安定リリースに移行しました。 Docker Compose 環境をアプリモデルに追加すると、Aspire は公開時にリソースから docker-compose.yaml を生成し、Docker Compose をサポートする環境に Aspire アプリケーションを簡単にデプロイできるようにします。

C# AppHost
TypeScript AppHost

var builder = DistributedApplication.CreateBuilder(args);

builder.AddDockerComposeEnvironment("compose");

builder.Build().Run();

import { 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder } from './.modules/aspire.js';

const 
const builder: IDistributedApplicationBuilder
builder = await 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder();

await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addDockerComposeEnvironment(name: string): DockerComposeEnvironmentResource
Adds a Docker Compose publishing environment
addDockerComposeEnvironment("compose");

await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.build(): DistributedApplication
Builds the distributed application
build().
DistributedApplication.run(cancellationToken?: cancellationToken): void
Runs the distributed application
run();

Aspire は、ネットワーク、ボリューム、環境変数など、アプリモデル内のリソースから完全な docker-compose.yaml を生成します。

Microsoft Foundry とホスト型エージェント

Aspire 13.2 は、以前の Azure AI Foundry に重点を置いたホスティングサーフェスを、より広範な Microsoft Foundry 統合に置き換えます。ホスティングパッケージは Aspire.Hosting.Foundry となり、Aspire.Hosting.Azure.AIFoundry を置き換えます。

これで、Foundry アカウントの追加、Foundry プロジェクトの作成、生成された FoundryModel カタログを使用したモデルデプロイメントの添付、および通常の Aspire アプリモデルからホストされたエージェントの公開ができるようになりました。

C# AppHost
TypeScript AppHost

var builder = DistributedApplication.CreateBuilder(args);

var foundry = builder.AddFoundry("foundry");
var project = foundry.AddProject("agents");

var chat = project.AddModelDeployment("chat", FoundryModel.OpenAI.Gpt5Mini);

builder.AddPythonApp("agent", "..\\agent", "main:app")
    .WithReference(project)
    .WithReference(chat)
    .PublishAsHostedAgent(project);

builder.Build().Run();

import { 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder } from './.modules/aspire.js';

const 
const builder: IDistributedApplicationBuilder
builder = await 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder();

const 
const foundry: FoundryResource
foundry = await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addFoundry(name: string): FoundryResource
Adds a Microsoft Foundry resource to the distributed application model.
addFoundry("foundry");
const 
const project: AzureCognitiveServicesProjectResource
project = await 
const foundry: FoundryResource
foundry.
FoundryResource.addProject(name: string): AzureCognitiveServicesProjectResource
Adds a Microsoft Foundry project resource to a Microsoft Foundry resource.
addProject("agents");

const 
const chat: FoundryDeploymentResource
chat = await 
const project: AzureCognitiveServicesProjectResource
project.
AzureCognitiveServicesProjectResource.addModelDeployment(name: string, model: FoundryModel | string, options?: {
    modelVersion?: string;
    format?: string;
}): FoundryDeploymentResource (+1 overload)
Adds a model deployment to the parent Microsoft Foundry resource.
addModelDeployment("chat", {
    
FoundryModel.name: string
name: "gpt-5-mini",
    
FoundryModel.version: string
version: "2025-06-01",
    
FoundryModel.format: string
format: "OpenAI",
});

await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addPythonApp(name: string, appDirectory: string, scriptPath: string): PythonAppResource
Adds a Python script application resource
addPythonApp("agent", "../agent", "main:app")
    .
ExecutableResource.withReference(source: EndpointReference | string | uri, options?: {
    connectionName?: string;
    optional?: boolean;
    name?: string;
} | undefined): PythonAppResource (+2 overloads)
Adds a reference to another resource
withReference(
const project: AzureCognitiveServicesProjectResource
project)
    .
ExecutableResource.withReference(source: EndpointReference | string | uri, options?: {
    connectionName?: string;
    optional?: boolean;
    name?: string;
} | undefined): PythonAppResource (+2 overloads)
Adds a reference to another resource
withReference(
const chat: FoundryDeploymentResource
chat)
    .
ExecutableResource.publishAsHostedAgent(options?: {
    project?: AzureCognitiveServicesProjectResource;
    configure?: ((obj: HostedAgentConfiguration) => Promise<void>) | undefined;
} | undefined): PythonAppResource (+1 overload)
Publishes an executable resource as a hosted agent in Microsoft Foundry.
publishAsHostedAgent({ 
project?: AzureCognitiveServicesProjectResource | undefined
project });

await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.build(): DistributedApplication
Builds the distributed application
build().
DistributedApplication.run(cancellationToken?: cancellationToken): void
Runs the distributed application
run();

この領域の新しい API には、AddProject、AddModelDeployment、WithAppInsights、WithKeyVault、WithContainerRegistry、PublishAsHostedAgent、AddAndPublishPromptAgent があります。 RunAsFoundryLocal は引き続きローカルモデル開発に使用できますが、親リソースが Foundry Local として構成されている場合、Foundry プロジェクトはサポートされません。

詳細については、Microsoft Foundry 統合を参照してください。

Azure 仮想ネットワークとプライベートエンドポイントのサポート

Azure にデプロイする場合、リソースへのネットワークアクセスを保護することが重要です。新しい Aspire.Hosting.Azure.Network 統合により、仮想ネットワーク、サブネット、NAT ゲートウェイ、ネットワークセキュリティグループ (NSG)、プライベートエンドポイントをアプリホスト内で直接定義することで Azure リソースをロックダウンでき、クラウドインフラストラクチャが既定で安全であることが保証されます。

var vnet = builder.AddAzureVirtualNetwork("vnet");

// NSG ルールを使用してサブネットを追加する
var subnet = vnet.AddSubnet("web", "10.0.1.0/24")
    .AllowInbound(
        port: "443",
        from: AzureServiceTags.AzureLoadBalancer,
        protocol: SecurityRuleProtocol.Tcp)
    .DenyInbound(from: AzureServiceTags.Internet);

// 確定的な送信 IP 用の NAT ゲートウェイを追加する
var natGateway = builder.AddNatGateway("nat");
subnet.WithNatGateway(natGateway);

// 安全な接続のためにプライベート エンドポイントを追加する
var peSubnet = vnet.AddSubnet("private-endpoints", "10.0.2.0/27");
var storage = builder.AddAzureStorage("storage");
peSubnet.AddPrivateEndpoint(storage.AddBlobs("blobs"));

主な機能は次のとおりです:

仮想ネットワークとサブネット: AddAzureVirtualNetwork でネットワークを作成し、AddSubnet でサブネットを追加します。
NAT ゲートウェイ: AddNatGateway および WithNatGateway を使用して、決定的な送信パブリック IP アドレスを提供します。
ネットワークセキュリティグループ: 短縮方法 (AllowInbound、DenyInbound、AllowOutbound、DenyOutbound) を使用するか、明示的な AddNetworkSecurityGroup と WithSecurityRule を使用して完全に制御し、トラフィックフローを制御します。
プライベートエンドポイント: AddPrivateEndpoint を使用してプライベートネットワーク経由で Azure サービスに安全に接続します。これにより、プライベート DNS ゾーン、仮想ネットワークリンクが自動的に作成され、ターゲットリソースでのパブリックアクセスが無効になります。

詳細については、 Azure 仮想ネットワーク統合を参照してください。

Azure AI と組み込みのサポート

Azure AI Inference コンポーネントでは、チャットの完了に加えて埋め込みもサポートされるようになりました。 EmbeddingsClient を登録し、その上に IEmbeddingGenerator<string, Embedding<float>> を重ねることができます。

var builder = WebApplication.CreateBuilder(args);

builder.AddAzureEmbeddingsClient("embeddings")
    .AddEmbeddingGenerator();

var app = builder.Build();

app.MapGet("/embed", async (
    IEmbeddingGenerator<string, Embedding<float>> generator) =>
{
    var embedding = await generator.GenerateEmbeddingAsync("Hello, world!");
    return embedding.Vector.ToArray();
});

詳細については、 Azure AI 推論統合を参照してください。

Azure App Service の機能強化

新しい拡張メソッドによる展開スロットのサポート
スティッキースロットアプリ設定の修正
構成の名前付けの改善
SearchIndexerClient が Azure Search の拡張メソッドとして追加されました

詳細については、 Azure App Service 統合を参照してください。

Azure コンテナーレジストリ

Azure Container Registry 統合では、新しい WithPurgeTask メソッドによるスケジュールされたイメージクリーンアップがサポートされるようになりました。これにより、古いまたは未使用のコンテナイメージを cron スケジュールで自動的に削除する ACR パージタスクがプロビジョニングされます。

var acr = builder.AddAzureContainerRegistry("my-acr")
    .WithPurgeTask("0 1 * * *", ago: TimeSpan.FromDays(7), keep: 5);

さらに、新しい GetAzureContainerRegistry メソッドを使用すると、コンピューティング環境からレジストリに簡単にアクセスして、さらに構成を行うことができます。

詳細については、 Azure Container Registry 統合を参照してください。

Azure Data Lake Storage の統合

Aspire 13.2 では、Azure Data Lake Storage のホスティングとクライアント側の両方のサポートが追加されています。これにより、階層型名前空間ストレージを使用するチームにとって重要なギャップが解消され、Data Lake ユーザーには、DI 登録、再試行、ヘルスチェック、ロギング、テレメトリなどの通常の Aspire 統合の利点が提供されます。

C# AppHost
TypeScript AppHost

var builder = DistributedApplication.CreateBuilder(args);

var api = builder.AddProject<Projects.Api>("api");
var storage = builder.AddAzureStorage("storage");
var dataLake = storage.AddDataLake("data-lake");
var fileSystem = storage.AddDataLakeFileSystem("data-lake-file-system");

api.WithReference(dataLake)
   .WaitFor(dataLake)
   .WithReference(fileSystem)
   .WaitFor(fileSystem);

import { 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder } from './.modules/aspire.js';

const 
const builder: IDistributedApplicationBuilder
builder = await 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder();

const 
const api: ProjectResource
api = await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addProject(name: string, projectPath: string, options?: {
    launchProfileOrOptions?: ProjectResourceOptions;
}): ProjectResource (+1 overload)
Adds a .NET project resource
addProject("api", "../api");
const 
const storage: AzureStorageResource
storage = await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addAzureStorage(name: string): AzureStorageResource
Adds an Azure Storage resource
addAzureStorage("storage");
const 
const dataLake: AzureDataLakeStorageResource
dataLake = await 
const storage: AzureStorageResource
storage.
AzureStorageResource.addDataLake(name: string): AzureDataLakeStorageResource
Adds an Azure Data Lake Storage resource
addDataLake("data-lake");
const 
const fileSystem: AzureDataLakeStorageFileSystemResource
fileSystem = await 
const storage: AzureStorageResource
storage.
AzureStorageResource.addDataLakeFileSystem(name: string, options?: {
    dataLakeFileSystemName?: string;
} | undefined): AzureDataLakeStorageFileSystemResource (+1 overload)
Adds an Azure Data Lake Storage file system resource
addDataLakeFileSystem("data-lake-file-system");

await 
const api: ProjectResource
api.
ProjectResource.withReference(source: EndpointReference | string | uri, options?: {
    connectionName?: string;
    optional?: boolean;
    name?: string;
} | undefined): ProjectResource (+2 overloads)
Adds a reference to another resource
withReference(
const dataLake: AzureDataLakeStorageResource
dataLake)
   .
ProjectResource.waitFor(dependency: IResource, waitBehavior?: WaitBehavior): ProjectResource
Waits for another resource to be ready
waitFor(dataLake)Error ts(2345)  ― Argument of type 'AzureDataLakeStorageResource' is not assignable to parameter of type 'IResource'.
  Types of property 'withRoleAssignments' are incompatible.
    Type '{ (target: AzureEventHubsResource, roles: AzureEventHubsRole[]): AzureDataLakeStorageResource; (target: AzureStorageResource, roles: AzureStorageRole[]): AzureDataLakeStorageResource; }' is not assignable to type '{ (target: AzureAppConfigurationResource, roles: AzureAppConfigurationRole[]): IResource; (target: AzureOpenAIResource, roles: AzureOpenAIRole[]): IResource; (target: AzureContainerRegistryResource, roles: AzureContainerRegistryRole[]): IResource; (target: AzureEventHubsResource, roles: AzureEventHubsRole[]): IResou...'.
      Types of parameters 'target' and 'target' are incompatible.
        Property 'addHub' is missing in type 'AzureAppConfigurationResource' but required in type 'AzureEventHubsResource'.
   .
ProjectResource.withReference(source: EndpointReference | string | uri, options?: {
    connectionName?: string;
    optional?: boolean;
    name?: string;
} | undefined): ProjectResource (+2 overloads)
Adds a reference to another resource
withReference(
const fileSystem: AzureDataLakeStorageFileSystemResource
fileSystem)
   .
ProjectResource.waitFor(dependency: IResource, waitBehavior?: WaitBehavior): ProjectResource
Waits for another resource to be ready
waitFor(fileSystem);Error ts(2345)  ― Argument of type 'AzureDataLakeStorageFileSystemResource' is not assignable to parameter of type 'IResource'.
  Types of property 'withRoleAssignments' are incompatible.
    Type '{ (target: AzureEventHubsResource, roles: AzureEventHubsRole[]): AzureDataLakeStorageFileSystemResource; (target: AzureStorageResource, roles: AzureStorageRole[]): AzureDataLakeStorageFileSystemResource; }' is not assignable to type '{ (target: AzureAppConfigurationResource, roles: AzureAppConfigurationRole[]): IResource; (target: AzureOpenAIResource, roles: AzureOpenAIRole[]): IResource; (target: AzureContainerRegistryResource, roles: AzureContainerRegistryRole[]): IResource; (target: AzureEventHubsResource, roles: AzureEventHubsRole[]): IResou...'.
      Types of parameters 'target' and 'target' are incompatible.
        Property 'addHub' is missing in type 'AzureAppConfigurationResource' but required in type 'AzureEventHubsResource'.

builder.AddAzureDataLakeServiceClient("data-lake");
builder.AddAzureDataLakeFileSystemClient("data-lake-file-system");

詳細については、 Azure Data Lake ストレージを参照してください。

データベースの統合

MongoDB: 接続文字列オプションが正しく先頭にスラッシュを追加するようになりました。
MongoDB Entity Framework Core: 新しいクライアント統合 Aspire.MongoDB.EntityFrameworkCore
Oracle EF Core: マルチターゲットのサポートが追加されました
SQL Server: 新しい Aspire.Hosting.SqlServer エクスポート

新しい MongoDB EF Core プロバイダーにより、通常の Aspire エンリッチメントエクスペリエンスを維持しながら、MongoDB で EF Core を簡単に使用できるようになります。

builder.AddMongoDbContext<MyDbContext>("mongodb", databaseName: "appdb");

DbContext を自分で登録した場合でも、EnrichMongoDbContext<TContext>() を使用して Aspire インストルメンテーションおよびヘルス機能をオプトインできます。

Bun を使用した JavaScript ホスティング

JavaScript リソースは、WithBun() を使用してパッケージマネージャーとして Bun をオプトインできるようになりました。 Aspire は、Bun-backed アプリケーションに対して適切なパッケージマネージャーアノテーション、インストール動作、およびコンテナービルドイメージのデフォルトを構成します。このリリースでは、WithYarn() 経由で AddViteApp で Yarn を使用する場合の信頼性の問題も修正されています。

C# AppHost
TypeScript AppHost

var builder = DistributedApplication.CreateBuilder(args);

builder.AddViteApp("frontend", "./frontend")
    .WithBun()
    .WithDockerfileBaseImage(buildImage: "oven/bun:latest");

builder.Build().Run();

import { 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder } from './.modules/aspire.js';

const 
const builder: IDistributedApplicationBuilder
builder = await 
function createBuilder(): IDistributedApplicationBuilder
Creates a new distributed application builder
createBuilder();

await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.addViteApp(name: string, appDirectory: string, options?: {
    runScriptName?: string;
}): ViteAppResource (+1 overload)
Adds a Vite application resource
addViteApp("frontend", "./frontend")
    .
ViteAppResource.withBun(options?: {
    install?: boolean;
    installArgs?: string[];
} | undefined): ViteAppResource (+1 overload)
Configures Bun as the package manager
withBun()
    .
ExecutableResource.withDockerfileBaseImage(options?: {
    buildImage?: string;
    runtimeImage?: string;
} | undefined): ViteAppResource (+1 overload)
Sets the base image for a Dockerfile build
withDockerfileBaseImage({ 
buildImage?: string | undefined
buildImage: "oven/bun:latest" });

await 
const builder: IDistributedApplicationBuilder
builder.
IDistributedApplicationBuilder.build(): DistributedApplication
Builds the distributed application
build().
DistributedApplication.run(cancellationToken?: cancellationToken): void
Runs the distributed application
run();

詳細については、 Bun 統合ドキュメントを参照してください。

エミュレータのアップデート

Azure ServiceBus エミュレーターが 2.0.0 に更新されました
Azure App Configuration エミュレータが 1.0.2 に更新されました
CosmosDB プレビューエミュレーターの準備状況チェックが追加されました
Azure Managed Redis は、既定のスキームとして rediss:// を使用するようになりました
RunAsEmulator で複数の Azurite ストレージアカウントがサポートされるようになりました

AI モデルの更新

Microsoft Foundry モデルは自動的に更新されます
GitHub モデルが更新されました
AI モデルコード生成により、マークダウンが C# XML ドキュメントに変換されるようになりました

🚀 導入と公開

Kubernetes の改善

Kubernetes デプロイメントの YAML 公開の修正
ExcludeFromManifest によるリソースの処理の改善

Azure のデプロイメント

コンピューティング環境から公開されるコンテナーレジストリ
Azure App Service での環境正規化の処理の改善
デプロイメントの失敗に対するエラーメッセージの改善
プロビジョニング中の Azure ロールの割り当てとプライベートエンドポイント待機の改善
パイプラインサマリーのパブリッシュおよびデプロイにおけるマークダウンのサポート
リソースグループのパイプライン概要内の Azure portal リンク
Cosmos DB や AppContainers などの Azure 統合の多言語エクスポート対応範囲の向上

パイプラインの機能強化

正常に完了した後に表示されるパイプラインの概要情報
デプロイメント状態マネージャーでの環境名の検証
デプロイメントディレクトリの権限は現在のユーザーに制限されます

🐛 バグ修正

このリリースには、あらゆる分野にわたる多数のバグ修正が含まれています。

AppHostServer の DCP パス作成を修正しました
ランダム化されたポートのダッシュボード URL ポートログを修正しました
AUX 予約デバイス名による Windows 起動エラーを修正
RabbitMQEventSourceListener の競合状態を修正しました
証明書のシリアル番号の生成を修正しました
リソースロガーサービスの破棄とメモリリークを修正
さまざまな GenAI ツール定義の解析問題を修正しました
CLI インタラクティブプロンプトでの検索ハイライトのコントラストが改善されました
リソース詳細パネルの表示オプションボタンのツールチップを修正しました

⚠️ 破壊的な変更

サービス検出環境変数の名前付け

サービス検出環境変数は、エンドポイント name の代わりにエンドポイント scheme を使用するようになりました。

// サービス__myservice__myendpoint__0 = https://localhost:5001

// サービス__myservice__https__0 = https://localhost:5001

これにより、エンドポイントが同じスキームを共有する場合の一貫性が向上します。サービス検出環境変数の特定のエンドポイント名パターンに依存するコードまたは構成がある場合は、代わりにスキームベースのパターンを使用するように更新します。

統合された構成ファイル

Aspire は、古い分割構成モデルよりも aspire.config.json を優先するようになりました。

新しいスキャフォールドと更新されたツールはそこに統合設定を書き込み、apphost.run.json に存在していた起動プロファイルは同じファイルにマージされます。レガシーファイルは移行中に引き続き読み取られますが、.aspire/settings.json または apphost.run.json を直接編集するカスタムオートメーションがある場合は、そのロジックを aspire.config.json に移動することを計画してください。

リソースコマンドの名前変更

組み込みリソースコマンドでは、start、stop、restart という短い名前が使用されるようになりました。

コマンド名を直接スクリプト化した場合は、resource-start、resource-stop、resource-restart から移行してください。

aspire resource api start
aspire resource api stop
aspire resource api restart

ダッシュボードテレメトリ API がオプトインになりました

スタンドアロンダッシュボードでは、HTTP API がデフォルトでオフになっています。

ダッシュボードを直接ホストし、API に依存する場合は、ASPIRE_DASHBOARD_API_ENABLED=true を設定するか、同等の構成を指定して、明示的に有効にします。

{
  "Dashboard": {
    "Api": {
      "Enabled": true
    }
  }
}

`BeforeResourceStartedEvent` の動作

BeforeResourceStartedEvent は、状態が変化するたびではなく、実際にリソースを開始するときにのみ起動するようになりました。イベントハンドラーが以前の動作に依存している場合は、イベントハンドラーを更新します。

接続プロパティのサフィックス

接続プロパティのサフィックスが追加されました。接続プロパティに直接アクセスするコードの更新が必要になる場合があります。

AIFoundry から Foundry への移行

Aspire.Hosting.Azure.AIFoundry は、より広い Aspire.Hosting.Foundry サーフェスに置き換えられました。

アップグレードする場合は、次の両方の変更を加えます:

Aspire.Hosting.Azure.AIFoundry パッケージ参照を Aspire.Hosting.Foundry に置き換えます。
AddAzureAIFoundry() から AddFoundry() に移行し、AddDeployment() または AddModelDeployment() を使用してデプロイメントを明示的に追加します。

<ItemGroup>
  <PackageReference Include="Aspire.Hosting.Foundry" Version="13.2.0" />
</ItemGroup>

// 移行前
var ai = builder.AddAzureAIFoundry("ai");

// 移行後
var foundry = builder.AddFoundry("ai");
var project = foundry.AddProject("agents");
var chat = project.AddModelDeployment("chat", FoundryModel.OpenAI.Gpt5Mini);

これにより、ホスティング API が現在の Foundry ブランドに合わせられ、新しい Microsoft Foundry リリースに追加された新しいプロジェクト、デプロイメント、ホスト型エージェント機能が利用できるようになります。

`WithSecretBuildArg` の名前が `WithBuildSecret` に変更されました

わかりやすくするために、コンテナービルドシークレット API の名前が変更されました。

// 移行前
builder.AddContainer("worker", "contoso/worker")
    .WithDockerfile("../worker")
    .WithSecretBuildArg("ACCESS_TOKEN", accessToken);

// 移行後
builder.AddContainer("worker", "contoso/worker")
    .WithDockerfile("../worker")
    .WithBuildSecret("ACCESS_TOKEN", accessToken);

共有ヘルパーまたは拡張メソッドを通じてのみ古い名前を使用していた場合、これは通常、簡単な名前変更です。

`IAzureContainerRegistry` は廃止されました

IAzureContainerRegistry インターフェイスは廃止済みとしてマークされています。代わりに、コンピューティング環境では新しい ContainerRegistry プロパティを使用してください。

クライアント統合におけるデフォルトの Azure 資格情報の動作

Aspire Azure クライアント統合では、パラメーターなしの DefaultAzureCredential コンストラクターは使用されなくなりました。これは、Azure サービスで作業する ManagedIdentityCredential 以外の資格情報に依存するユーザーにとっては重大な変更です。新しい動作の詳細については、デフォルトの Azure 資格情報を参照してください。

⬆️ 今すぐアップグレードしてください

Aspire 13.2 へのアップグレードの指示に従って先に進み、このリリースの新しい CLI、TypeScript アプリホスト、ダッシュボード、ホスティング、および統合機能の使用を開始します。

このリリースで対処された問題の完全なリストについては、GitHub の Aspire 13.2 マイルストーンを参照してください。いつものように、問題を提出し、プルリクエストを送信し、このリリースの形成に協力してくれたコミュニティの貢献者全員に多大な感謝の気持ちを伝えたいと思います。Aspire は皆さんのおかげでより良くなりました。

Aspire 13.2.1

Aspire 13.2.1 は、信頼性の修正に重点を置いたパッチリリースです。

TypeScript AppHost SDK の重大な変更

次の TypeScript AppHost API の名前が変更されました。影響を受ける apphost.ts ファイルを適宜更新します。

前の名前	新しい名前	メモ
`runAsExistingFromParameters(name, resourceGroup)`	`runAsExisting(name, { resourceGroup })`	名前の変更と位置 → オプションオブジェクト。
`publishAsExistingFromParameters(name, resourceGroup)`	`publishAsExisting(name, { resourceGroup })`	名前の変更と位置 → オプションオブジェクト。
`withConnectionPropertyValue(name, value)`	`withConnectionProperty(name, value)`	文字列/参照値の統合 API。
`withParameterBuildArg(name, parameter)`	`withBuildArg(name, parameter)`	名前が統合された `withBuildArg` サーフェスに変更されました。