复核清单.md 2.8 KB

上线复核清单

一、部署前

## 上线前检查
- [ ] 目标环境已确认(OS、中间件版本、网络策略、是否可联网)
- [ ] 变更范围清单完整(含"不涉及什么")
- [ ] 备份已完成且**验证可恢复**(恢复到一个临时库试过)
- [ ] 回滚预案写清了触发条件、动作、耗时、数据影响
- [ ] 数据库变更有 DDL 与 DML 分开,且 DML 已确认影响行数
- [ ] 部署脚本已双人审核
- [ ] 变更窗口与客户/使用方已报备
- [ ] 监控告警已开启(应用、数据库、中间件)
- [ ] 生产验证用例已准备(只读验证,不造数据)

二、脚本审核要点

检查 说明
set -e 失败即停,避免带病继续
路径存在性判断 防止在错误目录执行删除
变量集中定义 无硬编码 IP / 密码 / 路径
关键步骤日志 出问题能看出卡在哪一步
备份在替换之前 顺序反了等于没备份
危险操作前有确认 删文件、改权限、重启

三、数据操作红线

红线 说明
不带 WHERE 的 UPDATE / DELETE 一条命令清库,绝对禁止
生产直接改业务数据 只能通过应用或经审批脚本
未备份先改 不可逆
单事务大批量更新 锁表,业务停摆
用 root 跑应用 权限过大

四、上线后

## 上线后验证(30 分钟内完成)
- [ ] 健康检查返回 UP
- [ ] 关键接口返回正常(登录、列表、核心业务动作)
- [ ] 页面无 502 / 504
- [ ] 日志无 ERROR 级别的异常堆栈
- [ ] 定时任务正常触发
- [ ] 数据库连接池水位正常
- [ ] 无异常告警

五、回滚判定

情况 动作
应用起不来,2 次重启失败 立即回滚应用,不排查
核心业务不可用 立即回滚,事后分析
错误率 > 5% 持续 10 分钟 立即回滚
非核心功能异常 评估后决定,可留观
性能下降但可用 观察,同时准备回滚

回滚不需要请示的三种情况:服务起不来、核心功能不可用、数据出现错误。

六、对外沟通(给客户的故障说明)

内容必须包含:

  1. 什么时间、什么功能受影响(客观描述,不含推测)
  2. 影响范围(多少用户/多少单)
  3. 已采取的措施
  4. 当前状态
  5. 后续计划

必须人工定稿。AI 写的说明常见问题是:把责任写模糊、堆砌空话、承诺没把握的时间点。客户看得出来。

七、留痕

  • 部署记录:docs/05-部署/{项目}-{版本}-部署记录.md
  • 记录:执行人、审核人、执行时间、每步结果、异常与处理
  • 部署脚本纳入仓库版本管理,不放在个人电脑里