SuperAPI AI 工具集

aspire

部署与运维

查看项目

更新于 10-15 20:34

技能介绍

用途:当任务涉及操作 Aspire 分布式应用时,优先通过 Aspire CLI 完成,而不是回退到临时的 dotnet、docker 或 shell 流程。资源通常在 AppHost 中定义,如 AppHost.cs、apphost.ts 或 AppHost/AppHost.csproj(Program.cs)。

主要能力:用 aspire start 和 aspire stop 启动、重启、停止 AppHost;检查资源、日志、追踪和文档;通过 aspire integration list 或 aspire integration search 发现集成,并用 aspire add 添加;用 aspire restore 恢复缺失的 TypeScript AppHost 支持文件;在移交 Playwright 前发现正确的前端 URL;管理 AppHost 密钥与 CLI 配置;发布部署应用,包括用 aspire do 执行单个命名步骤;用有文档支持的 AppHost 模式添加自定义仪表板或资源命令。

默认工作流:确认工作区是 Aspire 应用并识别 AppHost;用 aspire start 启动,在 git worktree 或共享本地状态有风险时用 --isolated;交互前用 aspire wait <resource> 等待资源健康;用 aspire describe 检查状态,再查看 aspire otel logs、aspire logs、aspire otel traces 和 aspire export;添加集成前用 aspire integration search <query> 搜索,再用 aspire docs search/get 获取工作流指导,必要时用 aspire docs api search/get 查 API 参考。AppHost 变更后重新运行 aspire start;仅单个资源变更时保持 AppHost 运行,使用资源命令、热重载、仪表板操作或 IDE 调试。

关键规则:优先用 aspire start 而非 dotnet run;aspire run 会阻塞终端,不适合代理工作流。git worktree 中 aspire start --isolated 既是启动也是重启命令;不要组合 aspire stop 与 aspire run。资源操作使用 aspire resource <resource-name> <command> 形式。features.defaultWatchEnabled 仅用于 Aspire 默认监视,不等同于按资源重建/重启/热重载。当资源自身有框架热重载或 HMR 时优先使用该工作流。多 AppHost 或发现不明确时用 --apphost <path>。需要机器可读输出时用 --format Json。不要猜测不熟悉的集成或命令形态,应查阅 aspire.dev 官方文档。切勿安装已过时的 Aspire 工作负载。

限制:不适用于非 Aspire .NET 应用;不适用于不涉及 Aspire AppHost 的纯容器流程;不替代正常的构建与测试命令(仅编译代码或运行单元测试时不应使用)。TypeScript AppHost 的 .modules/ 为生成文件,不可直接编辑,应通过 aspire add 重新生成 API。