在 Aspire 项目下使用 AgileConfig

SL88poT0q

什么是 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

dotnet add package AgileConfig.Aspire.Hosting --version 1.0.0首先安装 AgileConfig.Aspire.Hosting。 这个包是 AgileConfig 服务端的一个扩展。使用它配合 Aspire 可以直接启动 AgileConfig 容器并且简单配置它。
安装完后，我们在 Program 下添加如下代码：
using Aspire.Hosting.AgileConfig;var builder = DistributedApplication.CreateBuilder(args);var agileConfig = builder.AddAgileConfig(); // 添加 AgileConfig 服务端，这会启动一个 Containervar agileConfig_apiservice = agileConfig.AddApp("apiservice"); // 在 AgileConfig 添加一个应用 apiservice，客户端会从这里读取业务var agileConfig_webfrontend = agileConfig.AddApp("webfrontend"); // 在 AgileConfig 添加一个应用 webfrontend，客户端会从这里读取业务var apiService = builder.AddProject<Projects.AspireProjectWithAgileConfig_ApiService>("apiservice");var webFrontend = builder.AddProject<Projects.AspireProjectWithAgileConfig_Web>("webfrontend").WithExternalHttpEndpoints();apiService.WithReference(agileConfig_apiservice); // apiservice 项目引用 agileConfig_apiservice 应用apiService.WaitFor(agileConfig); // apiservice 项目等待 agileConfig container 启动后再启动自己webFrontend.WithReference(agileConfig_webfrontend);  // webFrontend 项目引用 agileConfig_webfrontend 应用webFrontend.WaitFor(agileConfig); // webFrontend 项目等待 agileConfig container 启动后再启动自己webFrontend.WithReference(apiService);webFrontend.WaitFor(apiService);builder.Build().Run();让我们解释一下关键代码：

• 添加 AgileConfig 服务端
  

var agileConfig = builder.AddAgileConfig();作用：启动一个 AgileConfig 服务端的 Docker 容器，作为配置中心。

• 在 AgileConfig 中注册应用
  

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

• 配置依赖关系
  

// API 服务依赖 AgileConfig 中的 apiservice 配置apiService.WithReference(agileConfig_apiservice);apiService.WaitFor(agileConfig); // 等待 AgileConfig 容器启动// Web 前端依赖 AgileConfig 中的 webfrontend 配置webFrontend.WithReference(agileConfig_webfrontend);webFrontend.WaitFor(agileConfig); // 等待 AgileConfig 容器启动// Web 前端依赖 API 服务webFrontend.WithReference(apiService);webFrontend.WaitFor(apiService); // 等待 API 服务启动作用：定义服务启动顺序和依赖关系。
关键方法：
WithReference()：声明某个服务依赖另一个服务（如配置或另一个项目）。
WaitFor()：确保被依赖的服务启动后再启动当前服务。

• 新的依赖关系如下
  

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

要连接 AgileConfig 服务端，我们需要在客户端项目添加新的包引用：
dotnet add package AgileConfig.Client.Aspire --version 1.0.0以 ApiService 项目为例：
using Aspire.AgileConfig.Client;var appName = "apiservice";var builder = WebApplication.CreateBuilder(args);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
关注我的公众号一起玩转技术