AMR 生产发布影响报告
当前生产发布点(四个服务取 EKS Pod 实态,DB / Catalog 取 Forgejo workflow 记录)
Web、API、Link、Admin 的发布点来自 Grafana / Prometheus(datasource prometheus,namespace nexu)查询 kube_pod_container_info 与 kube_pod_status_ready{condition="true"} 关联后的 Ready Pod 镜像;DB migration 与 Catalog 的发布点来自 Forgejo workflow 最近一次成功运行的 commit_sha。越新的发布点意味着该维度已上线越多内容,feature 表里只允许列出发布点之后的变更;发布点之前的 commit 属于已生效,归入「已在生产生效」一节。目标 commit 均为 feb5eb7fa。
nexu/amr-web · container web0abec4e99sha256:6362b52fab5f4a773b6a2f0e2b79efab5e3de442c192ec4272476d26d2796390amr-web :prod-0abec4e997c9…0abec4e99…feb5eb7fa):32 commits,其中 1 个触及该服务目录nexu/amr-api · container api0abec4e99sha256:3e3cbb349128fdc6cee6f738dc10ff1fab930adf92d5832ca4edd57f5d74a31camr-api :prod-0abec4e997c9…0abec4e99…feb5eb7fa):32 commits,其中 0 个触及该服务目录nexu/amr-link · container link180a48b23sha256:7645cc2cc0350c1dafba6b8e34fa3147856f2be77fa3c0da78495b991e660f8famr-link :prod-180a48b23811…180a48b23…feb5eb7fa):34 commits,其中 3 个触及该服务目录nexu/amr-admin · container admin58e310d6fsha256:cb59b14ebf91908bfed2500ebebf597d17396ac72c3fe7afd0d5eafbe082e43eamr-admin :prod-58e310d6f4f4…58e310d6f…feb5eb7fa):33 commits,其中 0 个触及该服务目录ff912897dff912897d…feb5eb7fa):4 commits,其中 0 个命中该维度目录db/migrations 或 db/schema:本次无待执行 migration20260914115313_account_erasure.sql(#2001)等,见「已在生产生效」)feb5eb7fafeb5eb7fa…feb5eb7fa):0 commits,其中 0 个命中该维度目录EKS 观察口径:每个服务先用业务容器 + 镜像仓库精确过滤 kube_pod_container_info{container="…", image=~".*/amr-…:prod-[0-9a-f]{40}"},再按 (namespace, pod) 关联 Ready 指标,因此不含 API CronJob、Link Redis、metrics exporter 等附属工作负载。四个服务的 Ready Pod commit 与 digest 在各自集合内一致,spec / updated / available 副本数一致,样本时间距查询时刻均远小于 5 分钟。
此次发布真正新增的 feature 和影响面
| Feature / Author / Commits | Web | API | Link | Admin | DB schema / migration | DB catalog(seed) |
|---|---|---|---|---|---|---|
|
MProvider 失败诊断与余额耗尽检测(Link)
Provider 调用失败时不再只留下合成的 Author:nettee |
无。 | 无。 | 变更 services/link/internal/bifrostengine/engine.go(attempt 日志)、third_party/bifrost-core/bifrost.go 与 schemas/bifrost.go(观察者透传原始错误)、internal/handlers/openai.go、新增 internal/providerfailure/classifier.go(分类契约)、internal/server/server.go(装配与预热)、internal/usage/metrics.go(指标注册),含对应单测与 e2e 回归。 |
无。 | 无。 | 无。 |
|
S认证定价页年付文案去重(Web)
AMR 两处定价面(Public Pricing embed 与 Cloud Pricing)简体中文年付副行去掉重复的省钱金额: Author:Liu Yi |
变更 apps/web/src/components/commerce/plans/landing-pricing-content.ts、pricing-plans.tsx(各 1~2 行文案)与 apps/web/tests/unit/landing-pricing-sync.test.ts;仅影响 /pricing 云订阅与公共定价嵌入的中文副行渲染。 |
无。 | 无。 | 无。 | 无。 | 无 catalog 变更(data/json/public_pricing.json 已在 deploy-public-pricing-prod run 47216 @ 057e94ed1 时发布,定价数据无净新增)。 |
|
S生产发布工作流授权收敛(CI,不产生 runtime 变更)
生产发布入口的鉴权由「固定审批人名单」改为「Forgejo 授权 workflow + 运行时授权」: Author:Liu Yi |
无 runtime 变更。 | 无 runtime 变更。 | 无 runtime 变更。 | 无。 | 不影响 migration 执行内容(只决定谁能触发 workflow)。 | 不影响 seed 内容(只决定谁能触发 workflow)。 |
范围说明:各基线到 feb5eb7fa 的 commit 区间里还包含 apps/cli(vela CLI:#8/#22/#29/#31 等)、docs/ops(#30 发布 runbook 迁移到 Forgejo)、tools/、e2e/ 与其余 CI/dev 变更。它们不由 Web / API / Link / Admin / DB / Catalog 六个维度发布(CLI 走 vela-cli-release.yml),因此不作为本次 AMR 生产发布的影响面;相应地也不影响下表结论。
已在生产生效(发布点之前,本次不重复发布)
以下内容的 commit 均在各维度生产发布点之前,已在生产运行,因此从 feature 表中移出。
- Catalog(发布点 feb5eb7fa = HEAD,run 47325 @ 2026-09-20T12:09:32Z):该 run 已在 HEAD 上成功执行,catalog 与 main 完全对齐。已上线内容包括
8241f4cebGLM-5.3-FlashX(#18 feat(catalog): add GLM-5.3-FlashX:data/json/models.json、provider_routes.json、route_policies.json、provider_pricing/provider_zai.json、db/seeds/seed-model-routing-catalog.sql)、627a376c1+ec26c78caprovider model preflight 发现命令与--recent-days发布窗口(#23 #23、#28 #28)、b5bdfb782下线 legacy GPT-6 catalog workflow(#20 #20)、3374fc6d0本地 seed 防误连远程库(#13 #13)。本次发布 catalog 维度无净新增。 - DB migration(发布点 ff912897d,run 47209 @ 2026-09-20T08:13:07Z):范围内 0 个 commit 触及
db/migrations/db/schema。已执行的最新 migration 为db/migrations/20260914115313_account_erasure.sql(39abf116fGitHub PR #2001)与20260914101138_touchpoint_test_context_realtime.sql(GitHub PR #1996),均早于本发布点。 - Web(发布点 0abec4e99):
0abec4e99GitHub PR #2066—— 生产构建不再挂载 Test campaign 控制台(不再每 30s 轮询/runtime/test-deployments得到 404),并支持emptyResponse=200语义;该 commit 已在 amr-web 镜像中运行。 - API(发布点 0abec4e99):同一 commit 的 API 侧改动(
services/api/src/metrics.ts、src/touchpoints/routes.ts及单测)已随 amr-api 镜像生效;范围内 API 目录新增 0 个 commit。 - Link(发布点 180a48b23):该 commit 本身是 CLI 变更(
GitHub PR #2037),说明 amr-link 镜像恰好构建于此;Link 目录在此发布点之后共有 3 个 commit(其中 1 个仅改 e2e 测试)。已上线的 Link 侧内容为e736d1b3dGitHub PR #2049等 provider 目录/路由可观测性改动。 - Admin(发布点 58e310d6f):
58e310d6fGitHub PR #2064—— 审计行仍持久化,但被拒绝或不可达的 Bell 事件只记日志,不再把额度发放等操作变成 500;范围内 Admin 目录新增 0 个 commit。 - 范围内已回退(净变更归零,本次不发布):无。基线之后没有 revert commit,也没有需要特殊处理的「曾部署过的 migration」。
发布建议
- Migration 判断:不需要跑 migration。
db/migrations/db/schema在 ff912897d(DB 发布点)之后没有任何变更,重新触发 deploy-db-migrations-prod.yml 只会得到空变更集。 - 服务发布顺序:本次只需发布 Link 与 Web 两个镜像(API、Admin 在各自主 Pod 发布点之后无代码变更,重新发布是空变更):
- Link:
2 个有效变更 commit(#27 原始错误日志 → #32 余额耗尽分类与指标)→ 触发 deploy-link-eks-prod.yml。 - Web:
1 个有效变更 commit(#34 定价文案)→ 触发 deploy-web-eks-prod.yml。定价数据已由 public pricing 发布,无需重跑。
- Link:
- 数据 seed / catalog 判断:无 seed 变更需要 apply(Catalog 发布点 = HEAD)。若为流程一致性仍需跑一次 deploy-model-routing-catalog-prod.yml,其变更集为空,不会写入新数据。Web 定价文案属于应用内文案,不依赖
deploy-public-pricing-prod.yml。 - 发布后观测:
- Link 日志:
{namespace="nexu", pod=~"amr-link-.*"} |= "provider_attempt_failed" | json,确认upstream_status_code、failure_reason与最终 502 可按request_id关联。 - Link 指标:
gateway_provider_balance_exhausted_total零值序列应在启动后即可见(increase()可观测首个事件);随后可启用配套 GitOps 告警 PR powerformer/apps#573(必须先部署本次 Link 变更)。 - Link 健康:错误率/延迟与
upstream_credentials_exhausted比例不因日志与分类逻辑变化而改变(响应与重试语义未变)。 - Web:中文环境下
/pricing与公共定价嵌入的年付副行显示为按年计费 · $168/年,折扣标签仍显示一次优惠;公共定价嵌入页面无重复省钱提示。
- Link 日志:
备注:本报告的 workflow、commit、PR 与 compare range 均使用 Forgejo 链接(code.powerformer.net/core/amr);四个服务的 compare range 基于 EKS Pod 观察到的 BASE,DB / Catalog 基于各自 workflow 最近成功 run 的 commit。四个服务的 deploy-*-eks-prod.yml 在 Forgejo 中没有任何运行记录,仅作为审计对照缺失项列出,未用于推断生产版本。