在 Aspire 项目下使用 AgileConfig

什么是 Aspire

.NET Aspire 是一组工具、模板和包，用于构建易于监控的、可投入生产的应用程序。.NET Aspire 通过一系列 NuGet 包交付，这些包通过启动或办理当代应用开发中的特定题目来提拔开发效率。 现在的应用通常使用大量服务，例如数据库、消息传送和缓存，此中许多服务通过 .NET Aspire 集成得到支持。
Aspire 是微软发布的一项新技术。最近社区也有人跟我提需求说 AgileConfig 要支持 Aspire。
因为这不是 Aspire 的先容文章，所以不过多表述。想要了解可参考以下文档：
https://learn.microsoft.com/zh-cn/dotnet/aspire/get-started/aspire-overview
使用 AgileConfig 的传统方式

通常我们使用 AgileConfig 至少需要以下步骤：

• 使用 docker run 命令把服务端跑起来
  
• 配置 admin 密码
  
• 添加应用，设置 appId，secret
  
• 在客户端项目添加 client 包，修改 appsettings 配置文件
  

通过以上步骤后，你的应用至少应该是能成功连上 AgileConfig 服务端了。
在 Aspire 下使用 AgileConfig

下面让我们看看如何在 Aspire 下使用 AgileConfig。
相信大家肯定看过一些 Aspire 的案例。一些 infrastructure 的组件（比如 Sqlserver 数据库），可以通过 Aspire 直接运行起来，通过代码进行一些简朴的配置后，其他项目就可以使用了。
那么使用 AgileConfig 也是一样。让我们直接看代码吧。
新建 Aspire 项目

使用 VS 新建一个标准 Aspire 项目。末了我们会得到这样一个办理方案：

• AspireProjectWithAgileConfig.ApiService
  
• AspireProjectWithAgileConfig.AppHost
  
• AspireProjectWithAgileConfig.Web
  

他们之间的依赖关系如下：

在 AppHost 项目上使用 AgileConfig

1. dotnet add package AgileConfig.Aspire.Hosting --version 1.0.0

复制代码

首先安装 AgileConfig.Aspire.Hosting。 这个包是 AgileConfig 服务端的一个扩展。使用它配合 Aspire 可以直接启动 AgileConfig 容器而且简朴配置它。
安装完后，我们在 Program 下添加如下代码：

1. using Aspire.Hosting.AgileConfig;
3. var builder = DistributedApplication.CreateBuilder(args);
5. var agileConfig = builder.AddAgileConfig(); // 添加 AgileConfig 服务端，这会启动一个 Container
7. var agileConfig_apiservice = agileConfig.AddApp("apiservice"); // 在 AgileConfig 添加一个应用 apiservice，客户端会从这里读取业务
8. var agileConfig_webfrontend = agileConfig.AddApp("webfrontend"); // 在 AgileConfig 添加一个应用 webfrontend，客户端会从这里读取业务
10. var apiService = builder.AddProject<Projects.AspireProjectWithAgileConfig_ApiService>("apiservice");
11. var webFrontend = builder.AddProject<Projects.AspireProjectWithAgileConfig_Web>("webfrontend").WithExternalHttpEndpoints();
13. apiService.WithReference(agileConfig_apiservice); // apiservice 项目引用 agileConfig_apiservice 应用
14. apiService.WaitFor(agileConfig); // apiservice 项目等待 agileConfig container 启动后再启动自己
16. webFrontend.WithReference(agileConfig_webfrontend);  // webFrontend 项目引用 agileConfig_webfrontend 应用
17. webFrontend.WaitFor(agileConfig); // webFrontend 项目等待 agileConfig container 启动后再启动自己
19. webFrontend.WithReference(apiService);
20. webFrontend.WaitFor(apiService);
22. builder.Build().Run();

复制代码

让我们表明一下关键代码：

• 添加 AgileConfig 服务端
  

1. var agileConfig = builder.AddAgileConfig();

复制代码

作用：启动一个 AgileConfig 服务端的 Docker 容器，作为配置中央。

• 在 AgileConfig 中注册应用
  

1. var agileConfig_apiservice = agileConfig.AddApp("apiservice");
2. var agileConfig_webfrontend = agileConfig.AddApp("webfrontend");

复制代码

作用：在 AgileConfig 中注册两个应用 apiservice 和 webfrontend，它们的配置信息会被客户端读取。
细节：这两个应用对应实际的后端 API 和前端 Web 项目，后续客户端（如 apiService 和 webFrontend）会从 AgileConfig 中读取它们的配置。

• 配置依赖关系
  

1. // API 服务依赖 AgileConfig 中的 apiservice 配置
2. apiService.WithReference(agileConfig_apiservice);
3. apiService.WaitFor(agileConfig); // 等待 AgileConfig 容器启动
5. // Web 前端依赖 AgileConfig 中的 webfrontend 配置
6. webFrontend.WithReference(agileConfig_webfrontend);
7. webFrontend.WaitFor(agileConfig); // 等待 AgileConfig 容器启动
9. // Web 前端依赖 API 服务
10. webFrontend.WithReference(apiService);
11. webFrontend.WaitFor(apiService); // 等待 API 服务启动

复制代码

作用：定义服务启动顺序和依赖关系。
关键方法：
WithReference()：声明某个服务依赖另一个服务（如配置或另一个项目）。
WaitFor()：确保被依赖的服务启动后再启动当前服务。

• 新的依赖关系如下
  

在客户端项目上使用 AgileConfig.Client

要毗连 AgileConfig 服务端，我们需要在客户端项目添加新的包引用：

1. dotnet add package AgileConfig.Client.Aspire --version 1.0.0

复制代码

以 ApiService 项目为例：

1. using Aspire.AgileConfig.Client;
3. var appName = "apiservice";
5. var builder = WebApplication.CreateBuilder(args);
7. builder.Host.UseAspireAgileConfig(appName);

复制代码

客户端项目现在配置起来就超级简朴了，只需要一行代码就办理题目了，你乃至不需要去配置 appsettings 来指定 agileconfig 的相关配置它就能运行了。
运行

下面让我们运行整个项目看看结果吧。

通过 Aspire 的控制台我们可以看到 AgileConfig 的相关资源以及 2 个 project 项目都已经启动了。

点击 AgileConfig 的终结点可以直接打开 AgileConfig 的控制台。使用 admin/123456 默认密码就可以登录进去。

打开应用配置界面，可以看到 apiService， webfrontend 项目已经主动建立起来。

打开终端界面，可以看到有两个客户端毗连在服务端上。

点击 webFrontend 的终结点可以直接打开这个 blazor 项目，可以正常运行。
总结

以上我们通过一个简朴的示例演示了在 Aspire 下如何使用 AgileConfig。跟传统方案比起来，你不再需要关心：如何使用 docker 运行 AgileConfig 的服务端，不再需要关心如何在 appsettings 下添加 AgileConfig 的相关配置。
可以看到过程还黑白常丝滑的。
源代码在这：
https://github.com/kklldog/Aspire.Hosting.AgileConfig
https://github.com/dotnetcore/AgileConfig