事前準備
Aspire を始める準備はできていますか?開始する前に、開発環境にいくつかの必須ツールが整っていることを確認してください。このガイドでは、Aspire ソリューションを自信を持って構築・実行するために必要なすべてのセットアップについて説明します。
-
言語ランタイムをインストール
Section titled “言語ランタイムをインストール”Aspire の C# AppHost は .NET を基盤としています。.NET は、モダンなアプリケーションとクラウド サービスを構築するための、無料でオープンソースのクロスプラットフォーム フレームワークです。.NET 10.0 SDK をインストールする必要があります。C# の事前知識は必須ではありません。
お使いのオペレーティング システム (Windows、macOS、Linux) に応じた インストール手順 に従ってセットアップを完了します。
Aspire の TypeScript AppHost には、サポートされている Node.js リリース (Node.js 20.19 以降、22.13 以降、または 24 以降) が必要です。
aspire initを実行すると、CLI はこのエンジン範囲をスキャフォールドされたpackage.jsonに書き込みます:package.json {"engines": {"node": "^20.19.0 || ^22.13.0 || >=24"}}また、サポートされている AppHost ルートのパッケージ マネージャー も必要です: npm (デフォルト、Node.js に含まれています)、pnpm、Yarn 4 以降 (Berry)、または Bun。Yarn Classic (v1) はサポートされていません。 Aspire CLI は
package.jsonのpackageManagerフィールドまたはプロジェクト ディレクトリと親ディレクトリのロックファイルからアクティブなツールチェーンを自動検出します。お使いのオペレーティング システム (Windows、macOS、Linux) に応じた Node.js のインストール手順 に従ってセットアップを完了します。別のパッケージ マネージャーを使う場合は、個別にインストールしてください:
-
OCI 準拠のコンテナー ランタイムをインストール
Section titled “OCI 準拠のコンテナー ランタイムをインストール”ローカル コンテナー サポート用に 1 つのランタイムを選択します。ほとんどの Aspire 開発者には Docker Desktop が推奨されるデフォルトです。
推奨されるデフォルト Docker Desktop をインストールコンテナーを構築・実行するための、馴染みがあり広くサポートされた環境です。
サポートされている代替案 Podman をインストールOpen Container Initiative (OCI) コンテナーを構築・実行するためのオープンソースでデーモンレスのランタイムです。
Aspire で Podman を使用
Podman をインストール後、
ASPIRE_CONTAINER_RUNTIMEを podman に設定します。Podman ランタイムを設定 export ASPIRE_CONTAINER_RUNTIME=podmanPodman ランタイムを設定 [System.Environment]::SetEnvironmentVariable("ASPIRE_CONTAINER_RUNTIME","podman","User")コミュニティ報告済み Rancher Desktop について詳しくユーザーから、特に Docker CLI を使用するよう設定した場合に成功したという報告を受けています。ただし、Rancher Desktop は正式にサポートされている Aspire シナリオではなく、定期的にテストされていません。
-
統合開発環境 (IDE) をインストール
Section titled “統合開発環境 (IDE) をインストール”Aspire は複数の IDE とコード エディターをサポートしています。ワークフローに最適なものを選択できます:
さらに、C# 言語サポートのため C# 拡張機能 をインストールしてください。
Aspire は次の IDE でもよく動作します:
- Visual Studio: C# 開発用のフル機能 IDE で、デバッグ、IntelliSense、Git サポートを備えています。
- JetBrains Rider: コード分析、リファクタリング、デバッグなどの高度な機能を備えた、クロスプラットフォーム対応の強力な C# IDE です。
Aspire 拡張機能をインストールした Visual Studio Code が、TypeScript AppHost の推奨環境です。
ローカル インストールの代替案を検討する (オプション)
Section titled “ローカル インストールの代替案を検討する (オプション)”ローカル マシンに前提条件をインストールしない場合は、GitHub Codespaces や Dev Containers などのクラウドベースのオプションを使用して Aspire ソリューションを開発できます。これらのオプションを使用すると、クラウド環境で作業でき、ローカル インストールが不要になりますが、ローカル インストールと同じパフォーマンスは提供されない場合があります。
Aspire チームは、すぐに開始できるように、事前設定されている Dev Container を備えた GitHub Codespaces 設定を保守しています: