Skip to main content

独立发布恢复

Asset
ADP-DLV-FEAT-DOC-0022
Feature
ops-recovery
领域
delivery-integrations
作用域
application-level
文档状态
draft
产品生命周期
active
文档 Owner
DOC
事实源
canonical-docs
工程 Owner
WSI
Development Ready
not-ready
更新
2026/10/14

FEATURE DEVELOPMENT PACKAGE

工程就绪状态

工程 Owner：WSI · 仓库：DSP / PLN / WSI

BLOCKED
development · not ready
  • 原子需求与验收
  • 设计与工程合同
  • 代码与仓库定位
  • 里程碑与工作包
  • 验证计划
  • 无阻断决策
verification · not ready
  • Development Ready 已通过
  • 验收标准已覆盖
  • 正式测试已登记
  • Fixture 与环境已定义
  • 测试规格已物化到正式测试
release · not ready
  • Verification Ready 已通过
  • 实现修订可定位
  • 发布证据已登记
  • 兼容与迁移已定义
  • Runbook 与回滚已定义
查看阻断项（4）
  • Development Ready 缺少：原子需求与验收
  • Development Ready 缺少：设计与工程合同
  • Development Ready 缺少：里程碑与工作包
  • Development Ready 缺少：验证计划
查看完整 readiness查看关联资产

功能目标​

为 Plane 的 GitLab protected-tag build、Harbor immutable bundle、GitOps MR 和 Argo CD reconciliation 提供可观察、可复验的恢复合同。

功能结论​

主题结论
入口exact tag pipeline/jobs/artifacts、Harbor digests、GitOps MR、Argo CD application 与 runtime observation。
系统保证build 与 promotion 绑定同一 tag/commit/pipeline；TEST 自动推进，PRODUCTION 只生成待人工审核的 MR。
明确不做不移动 tag、不 rebuild during promotion、不直接写 cluster/DB，也不绕过 GitOps MR。
事实 ownerGitLab：pipeline/MR；Harbor：digests；Git：desired state；Argo CD/runtime：deployment observation。

恢复只使用 autoai/autodev-plane 仓库原生 release control 与上述 owning surfaces。 DSH/TeamCity 不提供 Plane release fallback，也不得用 Automation Run 或 business state 补足发布证据。

诊断顺序​

  1. 固定 release version、protected tag、source commit、pipeline id 和失败 job；禁止使用 latest 或模糊 ref。
  2. validate/build/seal 失败时，从该 exact tag pipeline 的 job evidence 定位。identity-bearing source 或 build input 改变时，必须以普通 source MR 和新 version/tag 修复；不得移动旧 tag。
  3. render 或 TEST promotion 失败时，核对 sealed artifact、canonical desired state、promotion branch/MR exact head 和 branch CI。修复 owning source 后走新 MR；不得手改 generated state 或绕过 checks。
  4. Argo CD TEST 不健康时，分别检查 Git revision、sync/health、migration hook、workload readiness、exact image digests 与 endpoint；GitLab success 不是 runtime success。
  5. TEST acceptance 失败时，通过普通 feature-fix MR 修复并发布新 immutable release。禁止修改已封存 digest 或把失败的 TEST release 推进到 PRODUCTION。
  6. PRODUCTION promotion 失败时，确认作业属于同一 tag/commit/pipeline、TEST observation 与 acceptance artifact 均匹配、master 上 TEST state 与 artifact 一致，并检查 branch/MR CI、exact head 与合并结果。
  7. PRODUCTION reconciliation 异常时，以 exact merged MR head、Argo revision、migration、workloads、digests 和 endpoint 为准。终态不明时停止新的 mutation 并保留 evidence。

重试与 reconciliation 上界​

自动修复必须有 attempt 和 wall-clock 上界；达到任一上界、同一失败重复出现、身份漂移或终态不明时转人工处理。只允许同一 owner 内的幂等 readback/reconciliation；不得通过重建、retag、手工改 desired state 或直接操作 cluster 来“继续重试”。

完成标准​

  • exact release identity、失败分类、是否已产生 side effect 清楚；
  • repair 进入 owning source MR，并由外部 CI 验证；
  • TEST 与 PRODUCTION 的 desired state、Argo/runtime evidence 分开记录；
  • 未恢复事项包含 blocker、下一 owner、所需授权与 residual risk。

历史 evidence 可以保留，但必须是 immutable、non-executable 且不参与当前判断。当前恢复入口只接受 exact GitLab pipeline/MR、Harbor digest、Git desired state 和 Argo/runtime observation。

Last updated on by source2728