次の方法で共有

.NET .NET Aspire のセットアップとツール

  • [アーティクル]

.NET .NET Aspire には、クラウドネイティブ アプリの作成と構成に役立つツールが含まれています。 このツールには、Visual Studio、Visual Studio Code、CLI ワークフローの .NET Aspire の使用を効率化するための便利なスターター プロジェクト テンプレートやその他の機能が含まれています。 前のセクションでは、.NET.NET Aspire ツールを使用する方法と、次のタスクについて説明します。

  • .NET .NET Aspire とその依存関係をインストールする
  • Visual Studio、Visual Studio Code、または .NET CLI を使用してスターター プロジェクト テンプレートを作成する
  • .NET .NET Aspire 統合をインストールする
  • .NET .NET Aspire ダッシュボードを操作する

.NET .NET Aspire のインストール

.NET .NET Aspireを使用するには、次のものがローカルにインストールされている必要があります。

Visual Studio 2022 17.9 以降には、Web & Cloud ワークロードをインストールするときに既定で最新の .NET.NET Aspire SDK が含まれています。

以前のバージョンの Visual Studio 2022 を使用している場合は、Visual Studio 2022 17.9 にアップグレードするか、次の手順を使用して .NET Aspire SDK をインストールできます。

Visual Studio 2022 で .NET Aspire ワークロードをインストールするには、Visual Studio インストーラーを使用します。

  1. Visual Studio インストーラーを開きます。

  2. 2022 の横にある [Visual Studio を選択します。

  3. ASP.NET と Web 開発 ワークロードを選択します。

  4. インストールの詳細 パネルで、.NET.NET Aspire SDKを選択します。

  5. .NET 統合をインストールするには、.NET Aspire の変更] を選択します。

    Visual Studio インストーラーを使用して .NET Aspire ワークロードをインストールする方法を示すスクリーンショット。

.NET .NET Aspire SDK の最新バージョンを確実にインストールするには...

コンテナー ランタイム

.NET .NET Aspire プロジェクトは、コンテナーで実行するように設計されています。 Docker Desktop または Podman をコンテナー ランタイムとして使用できます。 Docker Desktop は最も一般的なコンテナー ランタイムです。 Podman は、Open Container Initiative (OCI) コンテナーをビルドして実行できる、Dockerに代わるオープンソースのデーモンレスの代替手段です。 ホスト環境に Docker と Podman の両方がインストールされている場合、.NET Aspire は既定で Dockerを使用します。 DOTNET_ASPIRE_CONTAINER_RUNTIME 環境変数を podmanに設定することで、代わりに Podman を使用するように .NET Aspire に指示できます。

export DOTNET_ASPIRE_CONTAINER_RUNTIME=podman

詳細については、「に をインストールする 」を参照してください。

.NET .NET Aspire テンプレート

.NET .NET Aspire には、一連のソリューション テンプレートとプロジェクト テンプレートが用意されています。 これらのテンプレートは、お気に入りの .NET 開発者統合環境で使用できます。 これらのテンプレートを使用して、完全な .NET Aspire ソリューションを作成したり、既存の .NET Aspire ソリューションに個々のプロジェクトを追加したりできます。 詳細については、.NET.NET Aspire テンプレートのを参照してください。

.NET .NET Aspire ダッシュボード

アプリ ホスト プロジェクトを公開する .NET.NET Aspire テンプレートには、ログ、トレース、環境の構成など、アプリのさまざまな側面の監視と検査に使用される便利な開発者 ダッシュボード も含まれています。 このダッシュボードは、ローカル開発エクスペリエンスを向上させるために設計されており、アプリの全体的な状態と構造の概要を示します。

.NET .NET Aspire ダッシュボードは、アプリの実行中にのみ表示され、* を起動すると自動的に開始されます。AppHost プロジェクト。 Visual Studio および Visual Studio Code は、ブラウザーでアプリと .NET Aspire ダッシュボードの両方を自動的に起動します。 .NET CLI を使用してアプリを起動する場合は、出力からダッシュボードの URL をコピーしてブラウザーに貼り付けるか、Ctrl キー 押しながら し、リンクを選択します (ターミナルでハイパーリンクがサポートされている場合)。

CLI を使用してダッシュボードを起動する方法を示すスクリーンショット。

左側のナビゲーションには、ダッシュボードのさまざまな部分へのリンクが用意されています。各部分について、次のセクションで説明します。

.NET.NET Aspire ダッシュボードの [プロジェクト] ページのスクリーンショット。

.NET .NET Aspire ダッシュボードはスタンドアロン モードでも使用できます。 詳細については、「スタンドアロン .NET.NET Aspire ダッシュボード」を参照してください。

Visual Studio ツール

Visual Studio には、.NET Aspire 統合と App Host オーケストレーター プロジェクトを操作するための追加機能が用意されています。 現在、これらの機能の一部は、Visual Studio Code または CLI で使用できるわけではありません。

統合パッケージを追加する

Visual Studioを使用して、他の NuGet パッケージと同様に、.NET Aspire 統合をアプリに追加します。 ただし、Visual Studio には、.NET Aspire 統合を直接追加するための UI オプションも用意されています。

  1. で、 統合を追加するプロジェクトを右選択し、[ パッケージの追加]選択します。..。

    .NET Aspire コンポーネントの追加オプションを表示する Visual Studio コンテキスト メニュー。

  2. パッケージ マネージャーが開き、.NET.NET Aspire 統合用に事前に構成された検索結果 (フィルター条件の設定) が表示され、目的の統合を簡単に参照して選択できます。

    Visual Studio コンテキスト メニューには、.NET Aspire 統合オプションの追加が表示されています。

統合の詳細については、統合の概要 参照してください。

ホスティング パッケージを追加する

.NET .NET Aspire ホスティング パッケージは、アプリが依存または使用する可能性があるさまざまなリソースと依存関係を構成するために使用されます。 ホスティング パッケージは、* に追加されるという点で、他の統合パッケージと区別されます。AppHost プロジェクト。 ホスティング パッケージをアプリに追加するには、次の手順に従います。

  1. Visual Studioで、*.AppHost プロジェクトを右クリックして選択し、追加>.NET.NET Aspire パッケージ... を選択。

    .NET Aspire ホスティング リソースの追加オプションを表示する Visual Studio コンテキスト メニュー。

  2. パッケージ マネージャーが開き、.NET.NET Aspire ホスティング パッケージの検索結果が事前に構成 (フィルター条件の設定) され、目的のパッケージを簡単に参照して選択できます。

    .NET Aspire リソースの追加オプションを表示する Visual Studio コンテキスト メニュー。

オーケストレーション プロジェクトを追加する

次の手順 .NET.NET Aspire 使用して、オーケストレーション プロジェクトを既存のアプリに追加できます。

  1. Visual Studioで既存のプロジェクトを右クリックし、[追加] で>.NET.NET Aspire Orchestrator サポートを選択します。

    Visual Studio コンテキスト メニューに [.NET Aspire Orchestrator サポートの追加] オプションが表示されます。

  2. ダイアログウィンドウが開き、ソリューションに追加される*.AppHost および *.ServiceDefaults プロジェクトの概要が表示されます。

    Visual Studio.NET Aspire のオーケストレーション概要を示すスクリーンショット。

  3. [OK] 選択すると、次の変更が適用されます。

    • *.AppHost と *.ServiceDefaults オーケストレーション プロジェクトがソリューションに追加されます。
    • builder.AddServiceDefaults の呼び出しが、元のプロジェクトの Program.cs ファイルに追加されます。
    • 元のプロジェクトへの参照が、* の Program.cs ファイルに追加されます。AppHost プロジェクト。

オーケストレーション の詳細については、オーケストレーションの概要 参照してください。

オーケストレーションに参加する

では、新しいプロジェクト ワークフロー中に のオーケストレーション に登録する オプションが提供されます。 このオプションを選択すると、選択されたプロジェクト テンプレートと共に、Visual Studio が の *.AppHost プロジェクトと の *.ServiceDefaults プロジェクトを作成します。

オーケストレーションに参加する方法を示すスクリーンショット .NET.NET Aspire。

テスト プロジェクトを作成する

を使用していて、[アプリケーションの開始] テンプレート 選択すると、テスト プロジェクトを含めることができます。 このテスト プロジェクトは、テストの開始点として使用できるサンプル テストを含む xUnit プロジェクトです。

テスト プロジェクトを作成するオプションが表示 Visual Studio のスクリーンショット。

詳細については、「最初の .NET.NET Aspire テストを記述する」を参照してください。

Visual Studio Code ツール

.NET .NET Aspire プロジェクトの作成と開発には、C# Dev Kit 拡張機能と共に Visual Studio Codeを使用できます。 Visual Studio Codeで新しい .NET Aspire プロジェクトを作成するには、エクスプローラー ビューで .NET Project ボタンを選択し、.NET.NET Aspire テンプレートのいずれかを選択します。

Visual Studio Codeで新しい .NET Aspire プロジェクトを作成する方法を示すスクリーンショット。

新しい .NET Aspire プロジェクトを作成したら、アプリを実行してデバッグし、ブレークポイントをステップ実行し、Visual Studio Code デバッガーを使用して変数を検査します。

Visual Studio Codeで .NET Aspire プロジェクトをデバッグする方法を示すスクリーンショット。

参照してください