发布检查单

把发布前必做项列成清单:版本号与标签、变更说明、配置与迁移、回滚方案、通知与值守,逐项确认降低遗漏。

Git 与协作速查开发更新于 2026-10-13

发布检查单是什么

把发布前必做项列成清单:版本号与标签、变更说明、配置与迁移、回滚方案、通知与值守,逐项确认降低遗漏。它是流程的可执行表达:写进仓库模板或发布文档,能复用、能审计,比口口相传可靠。

基本信息

覆盖项版本/标签、变更说明、配置迁移、回滚方案、通知值守
责任人发布负责人加值守人,名单提前确认
留档发布记录与关键决策点写入文档或工单
自动化能由流水线检查的项(版本、测试、制品)尽量前置
复核节奏每季度核对一次清单与真实流程是否脱节

典型使用场景

  • 常规版本发布:逐项打勾确认,降低漏项概率。
  • 热修复:用精简版检查单,重点核对回滚与通知。
  • 新人值班:清单是交接材料,照单执行就能上手。
  • 合规要求:发布记录与批准链条留档,便于审计追溯。
  • 事故复盘:对照清单找出漏掉的环节,更新流程。
  • 自动化映射:把可检查项转成流水线门禁,减少人工依赖。

核对示意

核对示意
1) 版本号与标签规范一致        # git describe --tags 校验
2) 变更清单与已知问题已整理    # 附上 issue 与 MR 链接
3) 配置与数据库迁移脚本已评审  # 含回滚脚本
4) 回滚方案与触达名单就位
5) 值守人与通知渠道已确认

检查单组成

环节检查点产出物
变更准备版本号/标签/变更说明发布说明文档
风险控制回滚方案/迁移评审迁移与回滚脚本
执行窗口与值守确认发布记录
收尾通知与监控观察复盘记录
检查单写进仓库模板或发布文档,复用比口述可靠;能自动化的项目尽量交给流水线,人工只保留需要判断的环节。

易错点

  • 只在发布当天临时过一遍容易流于形式,关键项前置到流水线检查,让流程自己逼出遗漏。
  • 检查单长期不更新会与真实流程脱节,每季度复核一次,删掉过时项、补上新教训。
  • 清单没有责任人只有勾选项,出问题时互相等待,每个环节都要写明谁确认。
  • 把检查单当作万能流程,紧急修复走全量审批会拖延恢复,准备一份精简的热修复版本。

数据来源与参考

  • GitLab 官方文档:发布流程与检查项
  • GitHub 官方文档:发布管理(Releases)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌