构建你的.NET Aspire解决方案

.NET Aspire 是一组功能强盛的工具、模板和包，用于构建可观察的生产就绪应用步伐。.NET Aspire 通过处理特定云原生问题的 NuGet 包集合提供。云原生应用步伐通常由小型互连部分或微服务组成，而不是单个整体式代码库。云原生应用步伐通常会消耗大量的服务，例如数据库、消息收发和缓存。
.NET Aspire 旨在改善构建 .NET 云原生应用步伐的体验。它提供了一组同等的、有主见的工具和模式，可资助您构建和运行分布式应用步伐。NET Aspire 旨在资助您：

• 编排：.NET Aspire 为当地开发环境提供了运行和连接多项目应用步伐及其依赖项的功能。
  
• 集成：.NET Aspire 集成是适用于常用服务（如 Redis 或 Postgres）的 NuGet 包，具有标准化接口，可确保它们与您的应用步伐同等且无缝地连接。
  
• 工具：.NET Aspire 附带适用于 Visual Studio、Visual Studio Code 和 .NET CLI 的项目模板和工具体验，可资助你创建 .NET Aspire 项目并与之交互。
  

前提条件

• .NET 8.0 或 .NET 9.0
  
• 符合 OCI 标准的容器运行时，例如：
  
  
  
  • Docker Desktop 或Podman。
    
  
  
• 集成开发职员环境 （IDE） 或代码编辑器，例如：
  
  
  
  • Visual Studio 2022 版本 17.9 或更高版本（可选）
    
  • Visual Studio Code（可选）
    
    
    
    • C# 开发工具包：扩展（可选）
      
    
    
  • 带有 .NET Aspire 插件的 JetBrains Rider（（可选）
    
  
  

安装.NET Aspire 模板

如果尚未安装 .NET Aspire 模板，请运行以下命令：

1. dotnet new install Aspire.ProjectTemplates

复制代码

完成安装后，执行一下命令可看到aspire项目模板：

1. dotnet new list aspire
3. 模板名                        短名称                  语言  标记
4. ----------------------------  ----------------------  ----  -------------------------------------------------------
5. .NET Aspire 入门应用          aspire-starter          [C#]  Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud
6. .NET Aspire 应用主机          aspire-apphost          [C#]  Common/.NET Aspire/Cloud
7. .NET Aspire 服务默认值        aspire-servicedefaults  [C#]  Common/.NET Aspire/Cloud/Web/Web API/API/Service
8. .NET Aspire 测试项目(MSTest)  aspire-mstest           [C#]  Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
9. .NET Aspire 测试项目(NUnit)   aspire-nunit            [C#]  Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
10. .NET Aspire 测试项目(xUnit)   aspire-xunit            [C#]  Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
11. .NET Aspire 空应用            aspire                  [C#]  Common/.NET Aspire/Cloud/Web/Web API/API/Service

复制代码

从模板创建 .NET Aspire 空应用，请运行以下命令:

1. dotnet new aspire -o Stargazer

复制代码

创建的应用是一个最小的 .NET Aspire 项目，包括以下内容：

• Stargazer.AppHost：一个业务流程协调步伐项目，旨在连接和配置应用步伐的差别项目和服务。
  
• Stargazer.ServiceDefaults：一个 .NET Aspire 共享项目，用于管理在解决方案中与弹性、服务发现和遥测相干的项目中重复使用的配置。
  

集成服务

加入适用于常用服务（如 Redis 或 Postgres）的 NuGet 包Aspire.Hosting.PostgreSQL、Aspire.Hosting.Redis、Aspire.Hosting.MongoDB，然后在代码中创建docker容器：

1. using System.Runtime.InteropServices;
3. var builder = DistributedApplication.CreateBuilder(args);
5. string redisImage = "hub.atomgit.com/amd64/redis";
6. string postgresqlImage = "hub.atomgit.com/amd64/postgres";
7. string mongodbImage = "hub.atomgit.com/amd64/mongo";
8. Architecture architecture = RuntimeInformation.ProcessArchitecture;
9. if(architecture == Architecture.Arm
10.    || architecture == Architecture.Arm64)
11. {
12.     redisImage = "hub.atomgit.com/arm64v8/redis";
13.     postgresqlImage = "hub.atomgit.com/arm64v8/postgres";
14.     mongodbImage = "hub.atomgit.com/arm64v8/mongo";
15. }
16.    
17. var redis = builder.AddRedis("redis", 6379)
18.     .WithContainerName("redis")
19.     .WithImage(redisImage, "7-alpine")
20.     .WithDataVolume("redis")
21.     .WithRedisCommander(null, "redis-commander");
23. var username = builder.AddParameter("postgres-uid", "postgres");
24. var password = builder.AddParameter("postgres-pwd", "123456");
25. var postgres = builder.AddPostgres("postgres", username, password, 5432)
26.     .WithContainerName("postgres")
27.     .WithImage(postgresqlImage, "15-alpine")
28.     .WithDataVolume("postgres");
29. var postgresql = postgres.AddDatabase("postgresql");
31. var mongoUser = builder.AddParameter("mongo-user", "root");
32. var mongoPwd = builder.AddParameter("mongo-pwd", "123456");
33. var mongo = builder.AddMongoDB("mongo", 27017, mongoUser, mongoPwd)
34.     .WithContainerName("mongo")
35.     .WithImage(mongodbImage, "7-jammy")
36.     .WithDataVolume("mongo");
37. var mongodb = mongo.AddDatabase("mongodb");
39. IResourceBuilder<ProjectResource> apiService = builder.AddProject<Projects.Stargazer_Abp_Template_Host>("api-service");
41. builder.AddProject<Projects.Stargazer_Abp_Template_Web>("frontend")
42.     .WithExternalHttpEndpoints()
43.     .WithReference(redis)
44.     .WithReference(postgresql)
45.     .WithReference(mongodb)
46.     .WaitFor(redis)
47.     .WaitFor(postgres)
48.     .WaitFor(mongodb)
49.     .WithReference(apiService);
51. builder.Build().Run();

复制代码

启动应用步伐

运行以下命令启动应用步伐：

1. dotnet run --project Stargazer.AppHost

复制代码

访问https://localhost:17125/login?t=337c3ec0bfdadd302fcdb467d76453ad，就可以使用.NET Aspire 仪表板。

访问仪表板上的链接http://localhost:5136/，就可以访问应用步伐。

首发网站：https://stargazer.tech/2024/12/05/build-your-dotnet-aspire-solution/
相干链接

• .NET Aspire 官方文档   https://learn.microsoft.com/zh-cn/dotnet/aspire/
  
• 本文代码  https://github.com/huangmingji/Stargazer.Abp.Template/tree/main/modules/Aspire
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。