## 上线前检查
- [ ] 目标环境已确认(OS、中间件版本、网络策略、是否可联网)
- [ ] 变更范围清单完整(含"不涉及什么")
- [ ] 备份已完成且**验证可恢复**(恢复到一个临时库试过)
- [ ] 回滚预案写清了触发条件、动作、耗时、数据影响
- [ ] 数据库变更有 DDL 与 DML 分开,且 DML 已确认影响行数
- [ ] 部署脚本已双人审核
- [ ] 变更窗口与客户/使用方已报备
- [ ] 监控告警已开启(应用、数据库、中间件)
- [ ] 生产验证用例已准备(只读验证,不造数据)
| 检查 | 说明 |
|---|---|
set -e |
失败即停,避免带病继续 |
| 路径存在性判断 | 防止在错误目录执行删除 |
| 变量集中定义 | 无硬编码 IP / 密码 / 路径 |
| 关键步骤日志 | 出问题能看出卡在哪一步 |
| 备份在替换之前 | 顺序反了等于没备份 |
| 危险操作前有确认 | 删文件、改权限、重启 |
| 红线 | 说明 |
|---|---|
| 不带 WHERE 的 UPDATE / DELETE | 一条命令清库,绝对禁止 |
| 生产直接改业务数据 | 只能通过应用或经审批脚本 |
| 未备份先改 | 不可逆 |
| 单事务大批量更新 | 锁表,业务停摆 |
| 用 root 跑应用 | 权限过大 |
## 上线后验证(30 分钟内完成)
- [ ] 健康检查返回 UP
- [ ] 关键接口返回正常(登录、列表、核心业务动作)
- [ ] 页面无 502 / 504
- [ ] 日志无 ERROR 级别的异常堆栈
- [ ] 定时任务正常触发
- [ ] 数据库连接池水位正常
- [ ] 无异常告警
| 情况 | 动作 |
|---|---|
| 应用起不来,2 次重启失败 | 立即回滚应用,不排查 |
| 核心业务不可用 | 立即回滚,事后分析 |
| 错误率 > 5% 持续 10 分钟 | 立即回滚 |
| 非核心功能异常 | 评估后决定,可留观 |
| 性能下降但可用 | 观察,同时准备回滚 |
回滚不需要请示的三种情况:服务起不来、核心功能不可用、数据出现错误。
内容必须包含:
必须人工定稿。AI 写的说明常见问题是:把责任写模糊、堆砌空话、承诺没把握的时间点。客户看得出来。
docs/05-部署/{项目}-{版本}-部署记录.md