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