教程：将 Aspire 添加到现有 .NET 应用

1. 启动 Visual Studio，然后选择 文件>打开>项目/解决方案。

2. 导航到克隆的解决方案的顶级文件夹，选择 eShopLite.sln，然后选择 打开。

3. 在 解决方案资源管理器中，右键单击 eShopLite 解决方案，然后选择 配置启动项目。

4. 选择 多个启动项目。

5. 在 操作 列中，为 产品 和 应用商店 项目选择 启动。

6. 选择“确定”。

7. 若要开始调试解决方案，请按 F5 或选择 “开始”。

8. 在浏览器中打开两个页面：

   • 页面通过调用产品 Web API 以 JSON 格式显示产品。
   • 页面显示网站的主页。 在左侧菜单中，选择“产品” 以查看从 Web API 获取的目录。

9. 若要停止调试，请关闭浏览器。

1. 开始 Visual Studio Code 并打开克隆的文件夹。 从克隆存储库的终端运行以下命令：

   code .
   

2. 选择 运行和调试 菜单项，或者按下组合键 Ctrl+Shift+D。

3. 选择 创建 launch.json 文件 链接。

   

4. 将以下 JSON 复制并粘贴到此文件中，保存：

   • Unix
   • Windows

   {
       "version": "0.2.0",
       "compounds": [
           {
               "name": "Run all",
               "configurations": [
                   "Run products",
                   "Run store",
               ]
           }
       ],
       "configurations": [
           {
               "name": "Run products",
               "type": "dotnet",
               "request": "launch",
               "projectPath": "${workspaceFolder}/Products/Products.csproj"
           },
           {
               "name": "Run store",
               "type": "dotnet",
               "request": "launch",
               "projectPath": "${workspaceFolder}/Store/Store.csproj"
           }
       ]
   }
   

5. 若要开始调试解决方案，请按 F5 或选择 “开始”。

6. 在浏览器中打开两个页面：

   • 页面通过调用产品 Web API 以 JSON 格式显示产品。
   • 页面显示网站的主页。 在左侧菜单中，选择“产品” 以查看从 Web API 获取的目录。

7. 若要停止调试，请关闭浏览器，然后选择 停止 按钮两次（每个正在运行的调试实例一次）。

1. 打开终端窗口并将目录更改为新克隆的存储库。

2. 若要启动 Products 应用，请运行以下命令：

   dotnet run --project ./Products/Products.csproj
   

3. 浏览器页面会打开，显示产品的JSON。

4. 在单独的终端窗口中，再次将目录更改为克隆的存储库。

5. 运行以下命令启动 Store 应用：

   dotnet run --project ./Store/Store.csproj
   

6. 浏览器将打开一个页面，其中显示网站的主页。 在左侧菜单中，选择“产品” 以查看从 Web API 获取的目录。

7. 若要停止调试，请关闭浏览器，并在两个终端中按 Ctrl+C。

1. 在Visual Studio解决方案资源管理器中，右键单击应用商店项目，选择“添加”，然后选择Aspire“业务流程协调程序支持”。

2. 在 “添加 Aspire 业务流程协调程序支持 ”对话框中，选择“ 确定”。

   

您应该有两个新项目，这两个项目都已添加到解决方案中。

• eShopLite.AppHost：一个业务流程协调程序项目，旨在连接和配置应用的不同项目和服务。 协调器被设置为 启动项目，并依赖于 eShopLite.Store 项目。
• eShopLite.ServiceDefaults：一个 Aspire 共享项目，用于管理解决方案中与 复原、 服务发现和 遥测相关的跨项目重复使用的配置。

在 eShopLite.AppHost 项目中，打开 AppHost.cs 文件。 请注意，此代码行在Aspire编排中注册存储项目：

builder.AddProject<Projects.Store>("store");

有关详细信息，请参阅 AddProject。

若要将 Products 项目添加到 Aspire：

1. 在Visual Studio解决方案资源管理器中，右键单击“产品”项目，选择“添加”，然后选择“Aspire业务流程协调程序支持”。

2. 一个对话框， Aspire 指示 Orchestrator 项目已存在，请选择“ 确定”。

   

在 eShopLite.AppHost 项目中，打开 AppHost.cs 文件。 请注意，此代码行在Aspire编排中注册Products项目：

builder.AddProject<Projects.Products>("products");

另请注意，eShopLite.AppHost 项目现在依赖于 Store 和 Products 项目。

创建 AppHost 项目

若要协调现有项目，需要创建新的 AppHost 项目。 若要从可用模板创建新的 ，请使用以下 Aspire CLI 命令：

dotnet new aspire-apphost -o eShopLite.AppHost

将 AppHost 项目添加到现有解决方案：

dotnet sln ./eShopLite.sln add ./eShopLite.AppHost/eShopLite.AppHost.csproj

dotnet sln .\eShopLite.sln add .\eShopLite.AppHost\eShopLite.AppHost.csproj

使用以下 CLI 命令将应用商店项目添加为对 .NET 项目的项目引用：

dotnet add ./eShopLite.AppHost/eShopLite.AppHost.csproj reference ./Store/Store.csproj

dotnet add .\eShopLite.AppHost\eShopLite.AppHost.csproj reference .\Store\Store.csproj

有关可用模板的详细信息，请参阅 Aspire 模板。

创建服务默认项目

创建 AppHost 项目后，需要创建新的 服务默认 项目。 若要从可用的 模板创建新的 ，请使用以下 Aspire CLI 命令：

dotnet new aspire-servicedefaults -o eShopLite.ServiceDefaults

若要将项目添加到解决方案，请使用以下 .NET CLI 命令：

dotnet sln ./eShopLite.sln add ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet sln .\eShopLite.sln add .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

更新 AppHost 项目以添加对 Products 项目的项目引用：

dotnet add ./eShopLite.AppHost/eShopLite.AppHost.csproj reference ./Products/Products.csproj

dotnet add .\eShopLite.AppHost\eShopLite.AppHost.csproj reference .\Products\Products.csproj

商店 和 产品 项目都需要引用 服务默认项目 以便它们可以轻松集成 服务发现。 若要在 Store 项目中添加对 服务默认 项目的引用，请使用以下 .NET CLI 命令：

dotnet add ./Store/Store.csproj reference ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet add .\Store\Store.csproj reference .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

应使用具有略有不同的路径的相同命令在 Products 项目中添加对 服务默认值 项目的引用：

dotnet add ./Products/Products.csproj reference ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet add .\Products\Products.csproj reference .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

在 Store 和 Products 项目中，更新其 Program.cs 文件，并在 var builder = WebApplication.CreateBuilder(args); 行后立即添加以下行：

builder.AddServiceDefaults();

更新 AppHost 项目

AppHost.cs打开 AppHost 项目的文件，并将其内容替换为以下 C# 代码：

var builder = DistributedApplication.CreateBuilder(args);

builder.AddProject<Projects.Store>("store");

builder.AddProject<Projects.Products>("products");

builder.Build().Run();

前面的代码：

• 创建新的 DistributedApplicationBuilder 实例。
• 将 Store 项目添加到协调器。
• 将 Products 项目添加到编排器。
• 构建并运行协调器。

1. 在 Visual Studio中，若要开始调试，请按 F5，Visual Studio 将生成项目。
2. 如果出现“开始 Docker 桌面”对话框，请选择“是”。 Visual Studio 启动 Docker 引擎并创建所需的容器。 部署完成后，将显示Aspire仪表板。
3. 在仪表板中，选择 产品 项目的终结点。 此时会显示一个新的浏览器选项卡，并显示 JSON 格式的产品目录。
4. 在仪表板中，选择 商店 项目的终结点。 此时会显示一个新的浏览器选项卡，并显示 Web 应用的主页。
5. 在左侧菜单中，选择“产品”。 将显示产品目录。
6. 若要停止调试，请关闭浏览器。

删除之前创建的 launch.json 文件，它不再用作目的。 相反，启动 AppHost 项目，该项目协调其他项目：

1. 通过在解决方案资源管理器中右键单击 eShopLite.AppHost 项目并选择“调试>”来启动 AppHost 项目：

   

   Note

   如果 Docker 桌面（或 Podman）未运行，则会出现错误。 启动容器运行时，然后重试。

1. 运行以下命令启动 AppHost 项目：

   dotnet run --project ./eShopLite.AppHost/eShopLite.AppHost.csproj
   

   Note

   如果 Docker 桌面（或 Podman）未运行，则会出现错误。 启动容器运行时，然后重试。

2. 在仪表板中，选择 产品 项目的终结点。 此时会显示一个新的浏览器选项卡，并显示 JSON 格式的产品目录。
3. 在仪表板中，选择 商店 项目的终结点。 此时会显示一个新的浏览器选项卡，并显示 Web 应用的主页。
4. 在左侧菜单中，选择“产品”。 将显示产品目录。
5. 若要停止调试，请关闭浏览器。