一、首次部署
编排脚本负责三件事:拉取镜像、起容器、跑健康检查。手动一步步敲命令也能起来,但容易漏掉中间件依赖顺序。
# 1. 准备配置(不要提交到仓库)
cp env/.env.example env/.env
# 编辑 env/.env:数据库、Redis、对象存储、支付渠道
# 2. 一键部署
./zmd.sh deploy脚本执行完会打印一组健康检查结果,每一项都要是 PASS,有 FAIL 就先查那项,不要跳过往下走。
二、升级
升级与回滚必须成对存在。只有一个方向的升级路径,等于没有回滚方案。
# 记录当前版本(回滚要用)
./zmd.sh version
# 升级到指定版本
./zmd.sh upgrade --tag <版本号>升级过程中:
- 先备份数据库与素材(脚本会做,但要确认备份文件真的生成了)
- 执行数据库变更脚本
- 滚动替换容器
- 跑健康检查
三、回滚
./zmd.sh rollback --tag <上一个版本号>回滚只回滚应用,不回滚数据库。这是刻意的设计:数据库自动回滚一旦出错,数据就真的没了。
因此数据库变更脚本必须做到向后兼容:
- 加字段:给默认值,旧代码忽略新字段也能跑
- 删字段:分两次发布,先停用代码里对该字段的引用,下个版本再删
- 改类型:用新增字段 + 数据迁移的方式,不要原地改
四、失败时的处置顺序
遇到升级失败,按这个顺序走:
- 先回滚应用,恢复可用状态,不要在现场调试
- 保留现场:容器日志、数据库变更脚本执行记录、健康检查输出
- 在测试环境复现问题
- 定位后重新走升级流程
不要做:升级失败后继续在生产环境手工改代码或改库。此时系统状态已经不确定,任何手工改动都会让问题更难定位。
五、备份与恢复
- 备份脚本:
scripts/backup-b2c.sh,覆盖数据库与素材目录 - 恢复演练:至少每季度做一次完整恢复,只备份不恢复等于没备份
- 备份保留:按业务重要性定,默认保留最近 7 天日备 + 4 周周备
六、核对清单
| 阶段 | 核对项 |
|---|---|
| 部署前 | 数据库字符集 utf8mb4;磁盘余量 ≥ 20 GB |
| 部署后 | 健康检查全 PASS;管理后台可登录;前台首页可访问 |
| 升级后 | 版本号正确;核心链路(下单 / 支付 / 发货 / 售后)冒烟通过 |
| 回滚后 | 版本号回到上一版;健康检查全 PASS;数据库未回滚(确认数据仍在) |