作者：Jon Galloway
排版：Rani Sun
.NET Aspire 是一个针对 .NET 的新型云就绪堆栈，可帮助开发人员快速轻松地开发分布式应用程序。您可能已经看过一些演示，展示了大型 .NET 解决方案，其中充满了复杂的云依赖项，比如 Redis、Kafka 和 Postgres，也许您会想：这些技术也许有一天会用到，但对于我当前的项目来说，并没有太多的实际用途。
但 .NET Aspire 不仅仅涉及尖端技术和新兴应用程序；它还可以让您当前的应用更加简单。使用 .NET Aspire，您可以简化启动过程、改进监控并提高应用程序的可靠性。此外，您可以使用服务发现来增强您的应用程序，即使您尚未准备好使用更复杂的功能或服务（如 Redis 或容器化部署）。
在这篇文章中，我们将介绍如何轻松地改进现有解决方案 - 只需更轻松地维护和添加您已经在使用的功能。当然，您可以更轻松地集成更复杂的云依赖项和功能，这很好……但即使您从未这样做过，这仍然是一种胜利。
TLDR：在不到 5 分钟的时间内，您可以将 .NET Aspire 添加到您现有的应用程序中并获得仪表板、运行状况检查等......所有这些都无需改变您的应用程序的工作方式、CI/CD 管道或部署过程。
.NET Aspire
https://learn.microsoft.com/en-us/dotnet/aspire/
什么是 .NET Aspire？
如果您问五个人，您很可能会得到五个不同的答案。老实说，这有点难以描述，尝试简短地描述可能会变成一些流行语宾果游戏。实际上，这只是解决问题的一种方法：构建分布式应用程序很难。即使只是运行应用程序也需要启动一个或多个服务和前端，并确保它们可以相互通信，这可能会令人沮丧。如果这更容易，那不是很好吗？这就是 .NET Aspire 的目标，成为分布式应用程序的构建块，使它们更易于观察、更具弹性、更可扩展和更易于管理。
让我们来看看许多应用程序是如何随着时间的推移而演变的。很多应用程序都是从单一的整体概念验证开始的。您有一个带有数据库的应用程序。
假设您的概念验证成功，那么除了数据库之外，几乎每个现代应用程序都会发展到至少包含一个前端和一个后端。
然后，也许，如果我们的应用程序的使用和功能随着时间的推移不断增长，应用程序将变得真正分布式，依赖于大量的分布式依赖项。
但重点是！即使在非常简单的概念验证阶段，当然在前端-后端-数据库阶段，我们也可以从 .NET Aspire 中受益！只需几行代码，无需弄乱我们的 CI 或部署，我们就可以真正简化我们的日常开发人员体验。
第 1 步：使用 ServiceDefaults 启用因我们太忙而没有启用的 .NET 功能
多年来，ASP.NET Core 团队一直在开发一些很酷的功能，比如跟踪、运行状况检查和弹性。我已经做了多次关于“一小时 ASP.NET 改造”的会议演讲，我们只需打开并配置多年来一直存在的所有这些酷炫功能即可。但问题是……在阅读文档并练习之后，做这个演讲需要一个小时！如果我只是拨动一下“启用专业模式”开关会怎么样？
这就是 Service Defaults 为您做的事情。您只需打开 Service Defaults，即可获得智能日志记录、运行状况检查、弹性等功能，这些都基于 .NET 团队针对 ASP.NET Core 应用和服务的建议。如果您愿意，您可以轻松编辑 ServiceDefaults 项目中的 Program.cs 文件，但您不必这样做。只需将其打开即可。
添加 ServiceDefaults 项目
让我们看一个简单的前端 - 后端应用程序的示例。我将使用 Jeff Fritz 在 Let’s Learn .NET Aspire 活动系列中提供的新 MyWeatherHub 示例，从start-with-api 代码开始。
打开解决方案，我们将看到有两个项目：
MyWeatherHub – 一个显示实时天气数据的 Web 前端项目
API – 一个最小 API 项目，通过一组 HTTP API 端点公开来自美国国家气象局的实时天气数据
让我们将Service Defaults添加到这个解决方案中，以便我们可以在前端和后端同时获得运行状况检查、日志记录和其他推荐的功能。
在安装了 C# Dev Kit 的 Visual Studio 2022 或 Visual Studio Code 中，我们需要执行以下操作：
右键单击解决方案并选择 Add > New Project。
选择 .NET Aspire Service Defaults 项目模板。
将项目命名为 ServiceDefaults（如果您有创意，任何名称都可以，但本文中的说明假设您使用 ServiceDefaults）。
单击 Next > Create。
在 Visual Studio 2022 中的外观如下：
在 Visual Studio Code 中，它如下所示：
您还可以使用以下命令从命令行添加服务默认值：
dotnet new aspire-servicedefaults -n ServiceDefaults以上所有选项都只是将一个新项目放入您的解决方案中，该项目了解大多数 ASP.NET Core 分布式应用程序的最佳设置。但是，您现有的应用程序尚未使用它。接下来我们将连接它。
配置 ServiceDefaults
在 Api 和 MyWeatherHub 项目中添加对 ServiceDefaults 项目的引用：
右键单击 Api 项目并选择 Add > Reference。
检查 ServiceDefaults 项目并单击 OK。
右键单击 MyWeatherHub 项目并选择 Add > Reference。
检查 ServiceDefaults 项目并单击 OK。
Visual Studio 2022 提示
在 Visual Studio 2022 中，您可以将项目拖放到另一个项目上以添加引用。
在 Api 和 MyWeatherHub 项目中，更新它们的 Program.cs 文件，在 var builder = WebApplication.CreateBuilder(args); 行后立即添加以下行：
builder.AddServiceDefaults();在 Api 和 MyWeatherHub 项目中，更新它们的 Program.cs 文件，在 var app = builder.Build(); 行后立即添加以下行：
app.MapDefaultEndpoints();运行应用程序
首先，我们将使用多项目启动配置来启动应用程序。这很好，这是我们多年来一直采用的做法，但我不得不承认，我并不喜欢这种方式。请记住，我们将在下一步中简化此操作。我们将分两步进行，以明确服务默认值中发生了什么以及 AppHost 添加了哪些部分。
如果您使用的是 Visual Studio 2022，请右键单击 MyWeatherHub 解决方案并转到属性。选择 Api 和 MyWeatherHub 作为启动项目，然后选择OK。
现在单击“Start”以启动并调试两个项目。
如果您使用的是 Visual Studio Code，请使用“运行和调试”面板运行 Api 和 MyWeatherHub 项目。示例项目已包含一个 launch.json 文件，其中包含运行这两个项目所需的配置。
测试 Service Defaults 更改
通过导航到以下 URL 来测试应用程序：
o https://localhost:7032/swagger/index.html – API
o https://localhost:7274/ – MyWeatherHub
您应该看到 API 的 Swagger UI 和 MyWeatherHub 主页。
您还可以通过导航到 https://localhost:7032/health 查看 API 的运行状况检查。
您还可以通过导航至 https://localhost:7274/health 查看 MyWeatherHub 的运行状况检查。
查看终端中的日志以查看运行状况检查和其他遥测数据（例如 Polly 的弹性）：
Polly: Information: Execution attempt. Source: '-standard//Standard-Retry', Operation Key: '', Result: '200', Handled: 'False', Attempt: '0', Execution Time: '13.0649'点击 5 个不同的城市，将抛出“随机”错误。您将看到 Polly 重试策略的实际作用。
Polly: Warning: Execution attempt. Source: '-standard//Standard-Retry', Operation Key: '', Result: '500', Handled: 'True', Attempt: '0', Execution Time: '9732.8258'Polly: Warning: Resilience event occurred. EventName: 'OnRetry', Source: '-standard//Standard-Retry', Operation Key: '', Result: '500'System.Net.Http.HttpClient.NwsManager.ClientHandler: Information: Sending HTTP request GET http://localhost:5271/forecast/AKZ318一切正常……每个应用程序的输出都会在单独的控制台窗口中弹出，我们可以在终端中看到运行状况检查和日志。因此，我们打开了所有这些功能真是太好了，但管理所有这些 URL、浏览器选项卡和控制台窗口有点麻烦。您最终会在它们之间按 Alt-Tab 键，这是一种非常脱节的体验。
Service Defaults 在单个项目级别上运行得很好，但它无法帮助我们管理解决方案中的多个项目。这就是 AppHost 的作用所在。
launch.json 文件
https://github.com/dotnet-presentations/letslearn-dotnet-aspire/blob/main/start-with-api/.vscode/launch.json
第 2 步：使用 AppHost 简化启动并添加精美的仪表板
好吧，这很酷！我们在解决方案中添加了一个项目和两行代码，并获得了运行状况检查、日志记录、弹性等等。
但我们可以通过添加 AppHost 来让它变得更好。这种多项目配置功能是可行的，但是当我们向解决方案中添加其他项目时，设置和更新会有点麻烦。一旦我们开始运行，我们就必须浏览一系列具有不同端口的 URL，并分别管理每个项目。例如，如果我们想查看日志或输出，我们必须检查每个项目的控制台窗口。随着我们向解决方案添加更多 API 和服务，情况会变得更糟——需要管理更多的 URL、需要检查更多的控制台窗口等。我们可能在生产中设置了一些花哨的仪表板和监控，但这对我的开发没有帮助。
AppHost 有很多很棒的功能，但我最喜欢的两个是针对上述问题的解决方案：它简化了项目启动，并添加了一个很棒的仪表板来监控和管理我开发环境中的应用程序。了解其作用的最好方法是将其添加到我们的解决方案中。
添加 AppHost 项目
这是我们之前使用 ServiceDefaults 执行的标准“添加项目”步骤，但这次我们将选择“.NET Aspire App Host”作为项目模板。在 Visual Studio 2022 或安装了 C# DevKit 的 Visual Studio Code 中：
右键单击解决方案并选择 Add > New Project。
选择 .NET Aspire App Host 项目模板。
将项目命名为 AppHost（同样，任何名称都可以）。
单击 Next > Create。
从命令行，您可以执行以下操作：
dotnet new aspire-apphost -n AppHost就像我们添加 Service Defaults, 时一样，我们需要添加项目引用和几行代码来使 AppHost 工作。
添加项目引用
在新的 AppHost 项目中添加对 Api 和 MyWeatherHub 项目的引用：
右键单击 AppHost 项目并选择 Add > Reference。
选中 Api 和 MyWeatherHub 项目并单击OK。
注意：如果您记得之前的提示，可以将项目拖放到另一个项目上以添加引用。
添加这些引用时，源生成器会自动生成引用 App Host 中的项目所需的代码。
编排应用程序
在 AppHost 项目中，更新 Program.cs 文件，在 var builder = DistributedApplication.CreateBuilder(args); 行后立即添加以下行：
var api = builder.AddProject<Projects.Api>("api"); var web = builder.AddProject<Projects.MyWeatherHub>("myweatherhub");用最简单的方式运行应用程序！
之前，我们设置了一个多项目启动配置文件。这仍然有效，但从现在开始，您不必为此烦恼。而是将 AppHost 项目设置为启动项目。它了解所有其他项目，并会自动启动它们。这意味着，如果您在开始时添加 AppHost（或使用 .NET Aspire Starter Application 模板或 .NET Aspire Application 模板），则不再需要设置多项目启动配置文件。更好的是，如果您向解决方案添加更多服务，AppHost 也会自动选择它们。
在 Visual Studio 中，您可以通过右键单击 AppHost，然后单击“设置默认项目”并单击“启动”，将 AppHost 项目设置为 Visual Studio 中的启动项目。
如果您使用的是 Visual Studio Code，请将 launch.json 文件的内容替换为以下内容，然后在运行和调试面板中点击运行。
{ "version": "0.2.0", "configurations": [ { "name": "Run AppHost", "type": "dotnet", "request": "launch", "projectPath": "${workspaceFolder}\\AppHost\\AppHost.csproj" } ] }嘿，我们有一个仪表板！
还记得我们必须浏览一系列不同的 URL 才能查看我们的应用及其运行状况检查吗？现在，AppHost 将自动启动一个包含我们所有服务及其依赖项的仪表板。它将所有运行状况检查、跟踪、日志和环境变量等信息汇总到一个地方。而且，如果我们向解决方案添加更多服务，它们将自动显示在仪表板中。让我们来看看。
我们之前添加的 ServiceDefaults 项目会自动为我们的所有项目配置跟踪。我们可以在 Traces 选项卡中看到这一点。这是了解应用程序中的时间和依赖关系的好方法。
Metrics 选项卡向我们展示了有关应用程序的大量信息，包括 CPU 和内存使用情况以及请求和错误的数量。同样，这些都是由 ServiceDefaults 项目自动为我们设置的，并在 AppHost 仪表板中显示。
Structured 选项卡展示了我们应用中的所有结构化日志。这是查看应用程序中错误和其他重要信息的好方法。
总结
重点是，.NET Aspire 不仅适用于新应用程序或大型企业解决方案。它现在也适合您，它可以让您现有的应用程序变得更好。您可以将其添加到现有解决方案中，只需几行代码即可获得很多好处。而且，如果您还没有准备好使用更高级的功能，如服务发现或容器化部署，那也没关系。您仍然可以从 .NET Aspire 为您的应用程序带来的简单性和可靠性中受益。
