事前準備

Aspire を始める準備はできていますか？開始する前に、開発環境にいくつかの必須ツールが整っていることを確認してください。このガイドでは、Aspire ソリューションを自信を持って構築・実行するために必要なすべてのセットアップについて説明します。

1. 言語ランタイムをインストール

   TypeScript

   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 のインストール手順 に従ってセットアップを完了します。別のパッケージ マネージャーを使う場合は、個別にインストールしてください:

   • pnpm
   • Yarn
   • Bun
   C#

   Aspire の C# AppHost は .NET を基盤としています。.NET は、モダンなアプリケーションとクラウド サービスを構築するための、無料でオープンソースのクロスプラットフォーム フレームワークです。.NET 10.0 SDK をインストールする必要があります。C# の事前知識は必須ではありません。

   重要

   C# AppHost には .NET 10.0 SDK が必要です。ただし、Aspire は .NET 8.0 以降をターゲットとするアプリケーションを実行できます。

   お使いのオペレーティング システム (Windows、macOS、Linux) に応じた インストール手順 に従ってセットアップを完了します。

2. OCI 準拠のコンテナー ランタイムをインストール

   ローカル コンテナー サポート用に 1 つのランタイムを選択します。ほとんどの Aspire 開発者には Docker Desktop が推奨されるデフォルトです。

   Docker Desktop

   推奨されるデフォルトDocker Desktop をインストール

   コンテナーを構築・実行するための、馴染みがあり広くサポートされた環境です。

   Podman

   サポートされている代替案Podman をインストール

   Open Container Initiative (OCI) コンテナーを構築・実行するためのオープンソースでデーモンレスのランタイムです。

   Aspire で Podman を使用

   Podman をインストール後、ASPIRE_CONTAINER_RUNTIME を podman に設定します。

   Bash

   Podman ランタイムを設定

   export ASPIRE_CONTAINER_RUNTIME=podman

   PowerShell

   Podman ランタイムを設定

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

   Rancher Desktop

   コミュニティ報告済みRancher Desktop について詳しく

   ユーザーから、特に Docker CLI を使用するよう設定した場合に成功したという報告を受けています。ただし、Rancher Desktop は正式にサポートされている Aspire シナリオではなく、定期的にテストされていません。

   1 つのランタイムを選択

   上のタブから 1 つのオプションだけをインストールしてください。ほとんどのユーザーは Docker Desktop を選択します。Podman または Rancher Desktop を使いたいという理由がある場合を除き、それらをインストールしないでください。

3. 統合開発環境 (IDE) をインストール

   Aspire は複数の IDE とコード エディターをサポートしています。ワークフローに最適なものを選択できます:

   Visual Studio Code

   最適な利用体験のため、Visual Studio Code をお勧めします。軽量でクロスプラットフォーム対応のコード エディターで、Aspire のサポートが優れています。使い始めるには、次の拡張機能をインストールしてください:

   Aspire 拡張機能 - Aspire 固有のコマンドと機能用です。

   TypeScript

   Aspire 拡張機能をインストールした Visual Studio Code が、TypeScript AppHost の推奨環境です。

   C#

   さらに、C# 言語サポートのため C# 拡張機能 をインストールしてください。

   Aspire は次の IDE でもよく動作します:

   • Visual Studio: C# 開発用のフル機能 IDE で、デバッグ、IntelliSense、Git サポートを備えています。
   • JetBrains Rider: コード分析、リファクタリング、デバッグなどの高度な機能を備えた、クロスプラットフォーム対応の強力な C# IDE です。

ローカル インストールの代替案を検討する (オプション)

ローカル マシンに前提条件をインストールしない場合は、GitHub Codespaces や Dev Containers などのクラウドベースのオプションを使用して Aspire ソリューションを開発できます。これらのオプションを使用すると、クラウド環境で作業でき、ローカル インストールが不要になりますが、ローカル インストールと同じパフォーマンスは提供されない場合があります。

Aspire チームは、すぐに開始できるように、事前設定されている Dev Container を備えた GitHub Codespaces 設定を保守しています: