技术速递｜将 .NET Aspire 添加到您现有的 .NET 应用程序中

2024-08-21 23:20
文章标签 net aspire 应用程序 速递 现有 技术

本文主要是介绍技术速递｜将 .NET Aspire 添加到您现有的 .NET 应用程序中，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

作者：Jon Galloway
排版：Alan Wang

.NET Aspire 是一个针对 .NET 的新型云就绪堆栈，可帮助开发人员快速轻松地开发分布式应用程序。您可能已经看过一些演示，展示了大型 .NET 解决方案，其中充满了复杂的云依赖项，比如 Redis、Kafka 和 Postgres，也许您会想：这些技术也许有一天会用到，但对于我当前的项目来说，并没有太多的实际用途。

但 .NET Aspire 不仅仅涉及尖端技术和新兴应用程序；它还可以让您当前的应用更加简单。使用 .NET Aspire，您可以简化启动过程、改进监控并提高应用程序的可靠性。此外，您可以使用服务发现来增强您的应用程序，即使您尚未准备好使用更复杂的功能或服务（如 Redis 或容器化部署）。

在这篇文章中，我们将介绍如何轻松地改进现有解决方案 - 只需更轻松地维护和添加您已经在使用的功能。当然，您可以更轻松地集成更复杂的云依赖项和功能，这很好……但即使您从未这样做过，这仍然是一种胜利。

TLDR：在不到 5 分钟的时间内，您可以将 .NET Aspire 添加到您现有的应用程序中并获得仪表板、运行状况检查等…所有这些都无需改变您的应用程序的工作方式、CI/CD 管道或部署过程。

什么是 .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 中，我们需要执行以下操作：

  1. 右键单击解决方案并选择 Add > New Project。

  2. 选择 .NET Aspire Service Defaults 项目模板。

  3. 将项目命名为 ServiceDefaults（如果您有创意，任何名称都可以，但本文中的说明假设您使用 ServiceDefaults）。

  4. 单击 Next > Create。

在 Visual Studio 2022 中的外观如下：
在这里插入图片描述
在 Visual Studio Code 中，它如下所示：
在这里插入图片描述
您还可以使用以下命令从命令行添加服务默认值：

dotnet new aspire-servicedefaults -n ServiceDefaults

以上所有选项都只是将一个新项目放入您的解决方案中，该项目了解大多数 ASP.NET Core 分布式应用程序的最佳设置。但是，您现有的应用程序尚未使用它。接下来我们将连接它。

配置 ServiceDefaults

在 Api 和 MyWeatherHub 项目中添加对 ServiceDefaults 项目的引用：

  1. 右键单击 Api 项目并选择 Add > Reference。

  2. 检查 ServiceDefaults 项目并单击 OK。

  3. 右键单击 MyWeatherHub 项目并选择 Add > Reference。

  4. 检查 ServiceDefaults 项目并单击 OK。

Visual Studio 2022 提示
在 Visual Studio 2022 中，您可以将项目拖放到另一个项目上以添加引用。

  1. 在 Api 和 MyWeatherHub 项目中，更新它们的 Program.cs 文件，在 var builder = WebApplication.CreateBuilder(args); 行后立即添加以下行：
builder.AddServiceDefaults();
  1. 在 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 更改

  1. 通过导航到以下 URL 来测试应用程序：

  • https://localhost:7032/swagger/index.html – API

  • https://localhost:7274/ – MyWeatherHub

  1. 您应该看到 API 的 Swagger UI 和 MyWeatherHub 主页。

  2. 您还可以通过导航到 https://localhost:7032/health 查看 API 的运行状况检查。

  3. 您还可以通过导航至 https://localhost:7274/health 查看 MyWeatherHub 的运行状况检查。

  4. 查看终端中的日志以查看运行状况检查和其他遥测数据（例如 Polly 的弹性）：

Polly: Information: Execution attempt. Source: '-standard//Standard-Retry', Operation Key: '', Result: '200', Handled: 'False', Attempt: '0', Execution Time: '13.0649'
  1. 点击 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 的作用所在。

第 2 步：使用 AppHost 简化启动并添加精美的仪表板

好吧，这很酷！我们在解决方案中添加了一个项目和两行代码，并获得了运行状况检查、日志记录、弹性等等。

但我们可以通过添加 AppHost 来让它变得更好。这种多项目配置功能是可行的，但是当我们向解决方案中添加其他项目时，设置和更新会有点麻烦。一旦我们开始运行，我们就必须浏览一系列具有不同端口的 URL，并分别管理每个项目。例如，如果我们想查看日志或输出，我们必须检查每个项目的控制台窗口。随着我们向解决方案添加更多 API 和服务，情况会变得更糟——需要管理更多的 URL、需要检查更多的控制台窗口等。我们可能在生产中设置了一些花哨的仪表板和监控，但这对我的开发没有帮助。

AppHost 有很多很棒的功能，但我最喜欢的两个是针对上述问题的解决方案：它简化了项目启动，并添加了一个很棒的仪表板来监控和管理我开发环境中的应用程序。了解其作用的最好方法是将其添加到我们的解决方案中。

添加 AppHost 项目

这是我们之前使用 ServiceDefaults 执行的标准“添加项目”步骤，但这次我们将选择“.NET Aspire App Host”作为项目模板。在 Visual Studio 2022 或安装了 C# DevKit 的 Visual Studio Code 中：

  1. 右键单击解决方案并选择 Add > New Project。

  2. 选择 .NET Aspire App Host 项目模板。

  3. 将项目命名为 AppHost（同样，任何名称都可以）。

  4. 单击 Next > Create。

在这里插入图片描述
在这里插入图片描述
从命令行，您可以执行以下操作：

dotnet new aspire-apphost -n AppHost

就像我们添加 Service Defaults, 时一样，我们需要添加项目引用和几行代码来使 AppHost 工作。

添加项目引用

在新的 AppHost 项目中添加对 Api 和 MyWeatherHub 项目的引用：

  1. 右键单击 AppHost 项目并选择 Add > Reference。

  2. 选中 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 将自动启动一个包含我们所有服务及其依赖项的仪表板。它将所有运行状况检查、跟踪、日志和环境变量等信息汇总到一个地方。而且，如果我们向解决方案添加更多服务，它们将自动显示在仪表板中。让我们来看看。
在这里插入图片描述
首先，让我们看一下资源。这是我们解决方案中所有资源的便捷列表。我们可以看到 API 和 MyWeatherHub 项目，并在启动时观察它们的状态。我们还可以点击链接访问它们的端点、日志和跟踪信息。

我们之前添加的 ServiceDefaults 项目会自动为我们的所有项目配置跟踪。我们可以在 Traces 选项卡中看到这一点。这是了解应用程序中的时间和依赖关系的好方法。
在这里插入图片描述
Metrics 选项卡向我们展示了有关应用程序的大量信息，包括 CPU 和内存使用情况以及请求和错误的数量。同样，这些都是由 ServiceDefaults 项目自动为我们设置的，并在 AppHost 仪表板中显示。
在这里插入图片描述
Structured 选项卡展示了我们应用中的所有结构化日志。这是查看应用程序中错误和其他重要信息的好方法。
在这里插入图片描述

总结

重点是，.NET Aspire 不仅适用于新应用程序或大型企业解决方案。它现在也适合您，它可以让您现有的应用程序变得更好。您可以将其添加到现有解决方案中，只需几行代码即可获得很多好处。而且，如果您还没有准备好使用更高级的功能，如服务发现或容器化部署，那也没关系。您仍然可以从 .NET Aspire 为您的应用程序带来的简单性和可靠性中受益。

这篇关于技术速递｜将 .NET Aspire 添加到您现有的 .NET 应用程序中的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1094571。

相关文章

【专题】2024飞行汽车技术全景报告合集PDF分享（附原数据表）

【专题】2024飞行汽车技术全景报告合集PDF分享（附原数据表）

原文链接： https://tecdat.cn/?p=37628 6月16日，小鹏汇天旅航者X2在北京大兴国际机场临空经济区完成首飞，这也是小鹏汇天的产品在京津冀地区进行的首次飞行。小鹏汇天方面还表示，公司准备量产，并计划今年四季度开启预售小鹏汇天分体式飞行汽车，探索分体式飞行汽车城际通勤。阅读原文，获取专题报告合集全文，解锁文末271份飞行汽车相关行业研究报告。 据悉，业内人士对飞行汽车行业
阅读更多...
poj 1258 Agri-Net（最小生成树模板代码）

poj 1258 Agri-Net（最小生成树模板代码）

感觉用这题来当模板更适合。 题意就是给你邻接矩阵求最小生成树啦。~ prim代码：效率很高。172k...0ms。 #include<stdio.h>#include<algorithm>using namespace std;const int MaxN = 101;const int INF = 0x3f3f3f3f;int g[MaxN][MaxN];int n
阅读更多...
金融业开源技术 术语

金融业开源技术 术语

金融业开源技术  术语 1  范围 本文件界定了金融业开源技术的常用术语。 本文件适用于金融业中涉及开源技术的相关标准及规范性文件制定和信息沟通等活动。
阅读更多...
如何在Visual Studio中调试.NET源码

如何在Visual Studio中调试.NET源码

今天偶然在看别人代码时，发现在他的代码里使用了Any判断List<T>是否为空。 我一般的做法是先判断是否为null，再判断Count。 看了一下Count的源码如下： 1 [__DynamicallyInvokable]2 public int Count3 {4 [__DynamicallyInvokable]5 get
阅读更多...
2、PF-Net点云补全

2、PF-Net点云补全

2、PF-Net 点云补全 PF-Net论文链接：PF-Net PF-Net （Point Fractal Network for 3D Point Cloud Completion）是一种专门为三维点云补全设计的深度学习模型。点云补全实际上和图片补全是一个逻辑，都是采用GAN模型的思想来进行补全，在图片补全中，将部分像素点删除并且标记，然后卷积特征提取预测、判别器判别，来训练模型，生成的像
阅读更多...
cross-plateform 跨平台应用程序-03-如果只选择一个框架，应该选择哪一个?

cross-plateform 跨平台应用程序-03-如果只选择一个框架，应该选择哪一个?

跨平台系列 cross-plateform 跨平台应用程序-01-概览 cross-plateform 跨平台应用程序-02-有哪些主流技术栈？ cross-plateform 跨平台应用程序-03-如果只选择一个框架，应该选择哪一个? cross-plateform 跨平台应用程序-04-React Native 介绍 cross-plateform 跨平台应用程序-05-Flutte
阅读更多...
AI(文生语音)-TTS 技术线路探索学习:从拼接式参数化方法到Tacotron端到端输出

AI(文生语音)-TTS 技术线路探索学习:从拼接式参数化方法到Tacotron端到端输出

AI(文生语音)-TTS 技术线路探索学习:从拼接式参数化方法到Tacotron端到端输出 在数字化时代，文本到语音（Text-to-Speech, TTS）技术已成为人机交互的关键桥梁，无论是为视障人士提供辅助阅读，还是为智能助手注入声音的灵魂，TTS 技术都扮演着至关重要的角色。从最初的拼接式方法到参数化技术，再到现今的深度学习解决方案，TTS 技术经历了一段长足的进步。这篇文章将带您穿越时
阅读更多...
系统架构设计师： 信息安全技术

系统架构设计师： 信息安全技术

简简单单 Online zuozuo： 简简单单 Online zuozuo 简简单单 Online zuozuo 简简单单 Online zuozuo 简简单单 Online zuozuo ：本心、输入输出、结果 简简单单 Online zuozuo ： 文章目录 系统架构设计师： 信息安全技术前言信息安全的基本要素：信息安全的范围：安全措施的目标：访问控制技术要素：访问控制包括：等保
阅读更多...
前端技术(七)——less 教程

前端技术(七)——less 教程

一、less简介 1. less是什么？ less是一种动态样式语言，属于css预处理器的范畴，它扩展了CSS语言，增加了变量、Mixin、函数等特性，使CSS 更易维护和扩展LESS 既可以在 客户端 上运行 ，也可以借助Node.js在服务端运行。 less的中文官网:https://lesscss.cn/ 2. less编译工具 koala 官网 http://koala-app.
阅读更多...
Spring的设计⽬标——《Spring技术内幕》

Spring的设计⽬标——《Spring技术内幕》

读《Spring技术内幕》第二版，计文柯著。 如果我们要简要地描述Spring的设计⽬标，可以这么说，Spring为开发者提供的是⼀个⼀站式的轻量级应⽤开发框架（平台）。 作为平台，Spring抽象了我们在 许多应⽤开发中遇到的共性问题；同时，作为⼀个轻量级的应⽤开发框架，Spring和传统的J2EE开发相⽐，有其⾃⾝的特点。 通过这些⾃⾝的特点，Spring充分体现了它的设计理念：在
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2