SuperAPI AI 工具集

aspire

编程与开发

查看项目

更新于 10-16 00:04

技能介绍

用途:指导使用当前 Aspire 工具链构建、升级和运维 Aspire 13.5.x 的 C# 或 TypeScript 应用宿主,处理分布式应用编排、集成接线、测试与可观测性、部署及版本升级等任务。

主要能力:识别并创建三种一等 AppHost 形态(基于 Aspire.AppHost.Sdk 的 C# 项目、文件式 apphost.cs、TypeScript apphost.mts);用 WithReference 和 WaitFor 建模资源依赖与启动顺序;保持 ServiceDefaults 仅关注 OpenTelemetry、健康检查、服务发现与韧性;优先选用官方一方集成,能力确有缺口时再评估 CommunityToolkit/Aspire;提供测试、仪表板与部署路径建议。

使用方式:常用 CLI 入口包括 aspire new、aspire init、aspire add、aspire run、aspire start/stop/ps、aspire describe、aspire doctor、aspire secret、aspire docs、aspire deploy、aspire restore、aspire update。TypeScript 场景执行 aspire init --language typescript 生成 aspire.config.json 与 .aspire/modules/,改动后运行 aspire restore;测试可用 Aspire.Hosting.Testing 与共享 AppHost fixture。

适用场景:多服务与资源的本地或云端编排、ServiceDefaults 设置、多方集成选择、旧 8.x/9.x 方案升级,以及引入 Go、Bun、Java、Python 等多语言服务。

限制:13.5.0 含破坏性变更(ServiceProvider 改为 Services、PublishAsConnectionString 由 AddConnectionString 取代、ps 视图由 aspire describe 替代),建议至少使用 13.5.3;升级需先审计变更、对齐包版本、运行 aspire update --migrate 后重新验证。aspire publish 仍为预览敏感;仪表板不是生产监控替代品;不应在 AppHost 中写业务逻辑或硬编码服务 URL。