首页/开发/CI/CD 与发布速查/发布完成定义(Definition of Done)
质量门禁与回滚51 条

发布完成定义(Definition of Done)

为一次发布预先写清什么算完成:产物可追溯、验证通过、指标与通知到位;把口头约定变成检查清单,减少发布后的争议与遗漏。

CI/CD 与发布速查开发更新于 2026-10-13

发布完成定义是什么

发布完成定义为一次发布预先写清什么算完成:产物可追溯、验证通过、指标与通知到位、回滚路径确认;把口头约定变成检查清单,减少发布后的争议与遗漏。清单要控制在十分钟内可核对完,过长会被整体跳过;清单本身也要随系统演进定期更新。

基本信息

产物制品摘要与版本号已记录
验证冒烟与关键业务流验证通过
可观测监控面板、日志、告警已覆盖新版本
通知发布公告与变更记录已发出
回滚回滚路径已确认可用
责任人发布人与核对人分离,双人确认
归档清单随发布单归档,可检索

清单条目与证据

条目证据核对方式
产物归档摘要与版本记录对照制品库核对
功能验证冒烟结果流水线报告链接
可观测面板与告警覆盖抽查关键面板
通知变更记录公告链接与时间
回滚演练结果回滚步骤与耗时

发布清单片段

发布清单片段
# 发布清单片段
- [x] 制品 sha256 已归档
- [x] 冒烟用例通过
- [x] 5xx 与延迟面板正常
- [ ] 变更记录已发布
- [ ] 回滚演练结果已附
# 核对完成后发布公告写明版本与时间

典型使用场景

  • 常规发布:按清单逐项核对,双方确认后关闭发布单
  • 跨团队协作:清单作为共同口径,减少「以为对方做了」的遗漏
  • 新人上手:清单即流程教材,第一次发布照单执行
  • 变更审计:清单与证据留存,回答每次发布完成了什么
  • 回顾改进:统计清单中最常被遗漏的项,反向修补流程
  • 模板复用:按服务类型维护清单模板,发布单自动带出
清单规模控制在十分钟内可核对完:过长会被整体跳过。清单只列必要项,其余交给自动化检查。
勾选要有证据:没有链接与记录的勾选等于形式,核对时按同一标准要求。

易错点

  • 清单成为形式:无人核对仍勾选,失去意义
  • 清单不随系统演进更新:新增组件不在检查范围内
  • 勾选不要求证据:无法抽查与复核,形式主义蔓延
  • 核对只靠单人:缺少交叉确认,遗漏要到发布后才暴露

数据来源与参考

  • Google SRE Book《Release Engineering》
  • DORA/Accelerate 关于发布流程标准化的论述
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌