.NET Aspire 概述

引言

.NET Aspire 是 Microsoft 在 Build 2024 上推出的一个开源框架，旨在简化使用 .NET 8 及更高版本创建分布式云原生应用的流程。它通过提供一套工具、模板和最佳实践，让开发者能够更专注于业务逻辑而非基础设施的搭建。本文将详细介绍 .NET Aspire 的核心功能、优势以及如何快速上手使用这一创新框架。

什么是 .NET Aspire？

.NET Aspire 是一个开源框架，它结合了以下关键元素：

• 可组合应用的工具、模板和 NuGet 包
• 本地编排与部署能力
• 内置可观测性和遥测
• 与 Redis、PostgreSQL、健康检查等服务的简化集成

其目标是让开发人员专注于业务逻辑，而非基础设施流程，通过提供一个有主见、准备好生产环境的基线来实现这一目标。

核心功能

1. 编排与应用组合

Aspire 的核心是 AppHost，这是一个中央编排器，将多个 .NET 项目组合成可运行的分布式系统。有了它，开发者只需一个命令就能在本地运行整个应用，包括 API 服务、前端、数据库、缓存和消息队列。Aspire 负责处理依赖、容器设置和服务间配置。这种方法解决了本地 Docker Compose 设置的复杂性，并确保了开发与生产环境的一致性。

2. 有意见的组件与服务默认

Aspire 包含 ServiceDefaults 库，它预装了以下最佳实践配置：

• OpenTelemetry（日志记录、分布式追踪、指标）
• 健康检查
• 服务发现（动态连接注入）

这些默认设置可以通过一行代码（builder.AddServiceDefaults()）启用，即时为服务带来弹性和可观察性。

3. 快速设置的模板与工具

Aspire 支持 Visual Studio（v17.10+）、Visual Studio Code（配合 C# Dev Kit）以及通过模板实现的 .NET CLI。提供的模板包括"Aspire Application"和"Aspire Starter Application"，后者配备了 Blazor 前端，便于快速原型制作。这些模板为 AppHost、ServiceDefaults 以及可选的网页或 API 项目提供了支架，大大缩短了上线时间。

4. 开发者仪表盘与可观察性

运行 Aspire 应用会弹出一个内置仪表盘，显示：

• 日志
• 跟踪与分布式请求路径
• 运行时指标
• 活动容器与环境变量

仪表盘通常还包含 GitHub Copilot 集成，用于引导调试和洞察。

5. 灵活部署选项

编排组合可以导出到部署清单中，便于部署到：

• Azure Container Apps
• Kubernetes 集群
• ECS、AWS Lambda 或任何容器平台

这种方式避免了部署摩擦，同时保持配置一致性。

为什么要使用 .NET Aspire？

提升开发者生产力

Aspire 简化了模板流程，不再需要手动管理服务布线、堆栈设置或遥测。新开发者的入职速度快且可重复，包括在 CI/CD 环境中。正如一位 Reddit 用户所说："在开发阶段，我有一个环境，可以 F5，同时拥有所有服务，包括健康检查、OTEL、种子...全部配置和可查看。我可以连接无限多个测试，运行相同的程序...在 CI/CD 中完全相同。

跨环境的一致性

通过统一对开发、测试和生产进行处理------使用相同的 AppHost 组合和默认值------Aspire 确保本地运行的就是部署的。这大大减少了环境漂移。

内置可观测性与弹性

遥测、健康检查、重试和诊断均默认启用，节省时间并确保监控和可靠性的一致性。

基础设施复杂度降低

Aspire 抽象化了容器编排、环境变量注入和服务发现逻辑，使开发者能够声明式地组合服务。它补充了但不取代 Kubernetes。事实上，部署可以同时使用 Aspire Manifests 和 Kubernetes 进行扩展。

主要特性概述

特征	描述
AppHost 编排	管理多服务应用组合和容器编排的中央项目
服务默认	预烘焙配置，用于遥测、健康检查、弹性和服务发现
模板（CLI/IDE）	.NET Aspire 应用的入门和全栈模板
开发者仪表盘	显示实时日志、指标、痕迹、容器的网页界面
遥测（OpenTelemetry）	内置日志、追踪、跨 ASP.NET 指标、gRPC、HTTP
服务发现	动态注入 deps、连接字符串、端点
部署输出	部署到 Azure、Kubernetes 和容器，使用一致的 manifests
集成生态系统	支持 Redis、PostgreSQL、MongoDB、EF Core、Azure Storage、Dapr、Orleans 等

真实世界经验与报道

Visual Studio 杂志（2025 年 2 月）将 Aspire 描述为"一个旨在简化.NET 分布式系统开发的云原生应用栈"，强调自动仪表、健康检查、模板设置和仪表盘体验。

InfoWorld（2025 年 7 月）重点介绍了 Aspire 的编排和可观测性，称赞其在本地组合、遥测和集成管理方面的能力，即使是复杂的多服务配置。仪表盘中与 GitHub Copilot 的集成被特别强调为提升生产力的工具。

Code 杂志与 Syncfusion 提供 Aspire 编排优势的实用解释、明确的组件默认设置，以及使用 CLI 或 IDE 模板的逐步入门方法。

社区反馈（Reddit）显示，用户报告称在本地编排、集成测试以及开发与 CI 之间的一致性行为方面，显著节省了大量时间。

入门 .NET Aspire

先决条件

• .NET 8 SDK
• Visual Studio 2022 （17.10+）或 VS Code 搭配 C# 开发工具包
• Container runtime （Docker/Podman）

安装 Aspire

dotnet workload install aspire

创建项目

dotnet new aspire-starter --use-redis-cache --output AspireSample

本地运行

通过 IDE 或 CLI 启动：Aspire 启动容器、遥测、仪表盘等。

检查仪表盘

查看日志、指标、跟踪和容器状态。

自定义组件

修改 ServiceDefaults 或添加新的集成（例如，PostgreSQL、Kafka）。

部署

导出 manifests 用于 Azure Container Apps 或 Kubernetes 部署。

扩展或迁移现有应用

通过单一引用和 AddServiceDefaults() 调用注入 Aspire。

潜在考虑因素

学习曲线

其观点式结构可能与传统设置不同，过渡可能需要专注努力。

生态系统成熟度

Aspire 相对较新，集成覆盖和工具格局正在演变。

定制与主观默认

虽然默认能节省时间，但大量定制可能需要更深的知识。

生产使用模式

虽然生产准备就绪，但大规模生产部署模式（如多区域 Kubernetes）仍可能需要额外配置。

结论

.NET Aspire 是一款创新、注重生产力的工具包，简化了使用 .NET 创建分布式云原生应用的流程。它将编排、遥测、服务默认、模板和实时仪表盘结合，打造出一个既有主见又可扩展的开发者体验。无论你是从零开始构建，还是增强现有的.NET 服务，Aspire 都能让你更快上手，更有效地调试，并自信地部署。

通过提供标准化的开发体验、内置的可观测性和简化的部署流程，.NET Aspire 显著降低了构建分布式应用程序的复杂性，使开发者能够更专注于创造业务价值而非解决基础设施问题。随着生态系统的不断成熟，.NET Aspire 有望成为.NET 开发者构建云原生应用的首选框架。