diff --git a/docs/DEPLOYMENT_SOP.md b/docs/DEPLOYMENT_SOP.md index 8715b33..064d24c 100644 --- a/docs/DEPLOYMENT_SOP.md +++ b/docs/DEPLOYMENT_SOP.md @@ -21,6 +21,23 @@ > **使脚本执行失败时:修复脚本,而非绕过脚本。** +### 双备份先行原则(铁律 - 新增) + +> **在双备份(本地 `releases/v{version}/bk/` + 服务器 `/opt/piano-plan/releases/v{version}/bk/`)全部完成之前,禁止执行任何实质性的部署操作。** + +以下操作在双备份完成前**严禁**执行: +- ❌ 更新/修改生产数据库 schema +- ❌ 停止旧 Docker 容器 +- ❌ 启动新 Docker 容器 +- ❌ 上传/覆盖生产环境数据 +- ❌ 加载新镜像到服务器 + +正确流程: +1. ✅ 完成本地 `releases/v{version}/bk/` 备份 +2. ✅ 完成服务器 `/opt/piano-plan/releases/v{version}/bk/` 备份 +3. ✅ **验证两份备份均存在且完整** +4. ✅ **方可执行部署操作** + | 错误行为 | 正确行为 | |---------|---------| | 脚本报错 → `docker rm` 手动清理 | 脚本报错 → 查看日志 → 修复脚本问题 → 重跑脚本 |