AMR 生产发布影响报告

生成时间:2026-09-20T15:20:58Z(UTC);分析对象:从 origin/main(HEAD feb5eb7fa,fix(ci): delegate production authorization to runtime (#37))发布 Web、API、Link、Admin、DB migration 与 Model Routing Catalog 的影响分析。注意:Web / API / Link / Admin 四个服务以 EKS Ready Pod 实际运行镜像 tag 里的 commit 为生产发布点;DB migration 与 Model Routing Catalog 以对应 Forgejo workflow 最近一次成功运行的 commit_sha 为生产发布点;六个维度分别计算变更范围,不使用四个服务 workflow 的最近成功记录充当生产版本(Forgejo 中这四个 workflow 甚至没有任何运行记录,且 GitOps 可能被手工回滚)。

当前生产发布点(四个服务取 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。

Web · EKS Pod 实态
Workload:nexu/amr-web · container web
观察时间:2026-09-20T15:20:59Z
Ready Pods:2 / 2(updated 2,available 2)
实际 commit:0abec4e99
镜像 digest:sha256:6362b52fab5f4a773b6a2f0e2b79efab5e3de442c192ec4272476d26d2796390
镜像仓库:amr-web :prod-0abec4e997c9…
Workflow 审计:deploy-web-eks-prod.yml 在 Forgejo 无成功运行记录(0 runs),无法作为对照,一律以 Pod 实态为准
本次新增(0abec4e99…feb5eb7fa):32 commits,其中 1 个触及该服务目录
(发布点之前已上线:CMS Test runtime 在生产构建中不再挂载,#2066)
API · EKS Pod 实态
Workload:nexu/amr-api · container api
观察时间:2026-09-20T15:21:02Z
Ready Pods:2 / 2(updated 2,available 2)
实际 commit:0abec4e99
镜像 digest:sha256:3e3cbb349128fdc6cee6f738dc10ff1fab930adf92d5832ca4edd57f5d74a31c
镜像仓库:amr-api :prod-0abec4e997c9…
Workflow 审计:deploy-api-eks-prod.yml 在 Forgejo 无成功运行记录(0 runs),无法作为对照,一律以 Pod 实态为准
本次新增(0abec4e99…feb5eb7fa):32 commits,其中 0 个触及该服务目录
(发布点之前已上线:#2066 配套的 touchpoints metrics / production-float 接口行为)
Link · EKS Pod 实态
Workload:nexu/amr-link · container link
观察时间:2026-09-20T15:21:05Z
Ready Pods:3 / 3(updated 3,available 3)
实际 commit:180a48b23
镜像 digest:sha256:7645cc2cc0350c1dafba6b8e34fa3147856f2be77fa3c0da78495b991e660f8f
镜像仓库:amr-link :prod-180a48b23811…
Workflow 审计:deploy-link-eks-prod.yml 在 Forgejo 无成功运行记录(0 runs),无法作为对照,一律以 Pod 实态为准
本次新增(180a48b23…feb5eb7fa):34 commits,其中 3 个触及该服务目录
(发布点之前已上线:内部模型目录 provider 名称暴露 #2049 等)
Admin · EKS Pod 实态
Workload:nexu/amr-admin · container admin
观察时间:2026-09-20T15:21:08Z
Ready Pods:2 / 2(updated 2,available 2)
实际 commit:58e310d6f
镜像 digest:sha256:cb59b14ebf91908bfed2500ebebf597d17396ac72c3fe7afd0d5eafbe082e43e
镜像仓库:amr-admin :prod-58e310d6f4f4…
Workflow 审计:deploy-admin-eks-prod.yml 在 Forgejo 无成功运行记录(0 runs),无法作为对照,一律以 Pod 实态为准
本次新增(58e310d6f…feb5eb7fa):33 commits,其中 0 个触及该服务目录
(发布点之前已上线:#2064 admin 操作在 APE publish 失败时不再返回 500)
deploy-db-migrations-prod.yml · workflow 记录
维度:DB migration(发布点来自该 workflow 最近成功 run)
最近成功 run:#47209 · 2026-09-20T08:13:07Z
发布点 commit:ff912897d
commit 标题:Deploy DB Migrations Prod
本次新增(ff912897d…feb5eb7fa):4 commits,其中 0 个命中该维度目录
范围内 4 个 commit 均未触及 db/migrations 或 db/schema:本次无待执行 migration
(发布点之前已上线:最近 migration 20260914115313_account_erasure.sql(#2001)等,见「已在生产生效」)
deploy-model-routing-catalog-prod.yml · workflow 记录
维度:Model Routing Catalog(发布点来自该 workflow 最近成功 run)
最近成功 run:#47325 · 2026-09-20T12:09:32Z
发布点 commit:feb5eb7fa
commit 标题:Deploy Model Routing Catalog Prod
本次新增(feb5eb7fa…feb5eb7fa):0 commits,其中 0 个命中该维度目录
该 run 在 HEAD(feb5eb7fa)上成功执行,catalog 已与 main 对齐:本次 catalog 维度无新增 seed / data 变更
(发布点即 HEAD,范围内新增 commit 数为 0,catalog 无净新增)

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 表只包含「各维度生产发布点之后」的变更:Web 以 0abec4e99、API 以 0abec4e99、Link 以 180a48b23、Admin 以 58e310d6f、DB migration 以 ff912897d、Catalog 以 feb5eb7fa 为基线。发布点之前已生效的内容见 「已在生产生效」 一节,不重复列入。

Feature 聚合规则:以业务行为、用户路径、数据契约和部署依赖为准;PR、commit、path 只作为可点击的追溯证据。

Feature / Author / Commits Web API Link Admin DB schema / migration DB catalog(seed)
MProvider 失败诊断与余额耗尽检测(Link)

Provider 调用失败时不再只留下合成的 502 upstream_credentials_exhausted:先在重试归一化之前输出结构化 attempt 日志(保留上游原始 status_code / code / type / message,并按 request_id 关联最终错误);再把已确认的 OpenRouter(HTTP 402 / code=402)与 TeamoRouter(enterprise_insufficient_balance / insufficient_balance)余额耗尽契约归一为 failure_reason=balance_exhausted,并累加低基数计数器 gateway_provider_balance_exhausted_total(启动与目录重载时预热零值序列)。Bifrost 重试、凭据轮换、最终响应与用量结算行为均不变,属于可观测性/运维面变更。对应 OPEND-3260,是排障与告警(余额耗尽)能力上线。

Author:nettee

Link 维度范围:180a48b23…feb5eb7fa

无。 无。 变更 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)简体中文年付副行去掉重复的省钱金额:按年计费 · $168/年(省 $72) → 按年计费 · $168/年,独立折扣标签保留,卡片仍只表达一次优惠;新增单测契约同时校验两处文案来源,防止回归。对应 OPEND-3386,为用户可见文案(i18n 文案 + 模板)变更,无数据/接口契约变化。

Author:Liu Yi

Web 维度范围:0abec4e99…feb5eb7fa

变更 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 + 运行时授权」:deploy-*-prod.yml 统一改为调用 authorize-prod-deployer.yml,并拒绝 run_attempt != 1 的原生重跑(重跑无法识别当前操作人)。这批 commit 位于所有维度发布点之后,影响的是本次发布的执行方式而不是运行时行为:发布必须由有权限的操作人从 main 发起一次新的 dispatch。

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 表中移出。

发布建议

  1. Migration 判断:不需要跑 migration。db/migrations / db/schema 在 ff912897d(DB 发布点)之后没有任何变更,重新触发 deploy-db-migrations-prod.yml 只会得到空变更集。
  2. 服务发布顺序:本次只需发布 Link 与 Web 两个镜像(API、Admin 在各自主 Pod 发布点之后无代码变更,重新发布是空变更):
    1. Link:2 个有效变更 commit(#27 原始错误日志 → #32 余额耗尽分类与指标)→ 触发 deploy-link-eks-prod.yml。
    2. Web:1 个有效变更 commit(#34 定价文案)→ 触发 deploy-web-eks-prod.yml。定价数据已由 public pricing 发布,无需重跑。
    Catalog 与 DB 维度无净新增,可不执行(Catalog 发布点即 HEAD)。
  3. 数据 seed / catalog 判断:无 seed 变更需要 apply(Catalog 发布点 = HEAD)。若为流程一致性仍需跑一次 deploy-model-routing-catalog-prod.yml,其变更集为空,不会写入新数据。Web 定价文案属于应用内文案,不依赖 deploy-public-pricing-prod.yml。
  4. 发布后观测:
    • 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/年,折扣标签仍显示一次优惠;公共定价嵌入页面无重复省钱提示。

备注:本报告的 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 中没有任何运行记录,仅作为审计对照缺失项列出,未用于推断生产版本。