生产环境发布部署技能

快速开始

触发场景：

"发布到生产"
"部署代码"
"上线新功能"
"执行发布流程"

核心流程（10 步）：

本地测试 → 2. DB 结构对比 → 3. 前端构建 → 4. 回归测试 → 5. 备份生产 → 6. 部署代码 → 7. 执行迁移 → 8. 重启服务 → 9. 生产验证 → 10. 记录发布

服务器配置

生产服务器：157.245.56.178
用户名：root
密码：7758258Liu
端口：22
部署路径：/var/www/sm-dating-website/
前端构建：/home/administrator/.openclaw/workspace-main/projects/sm-dating-website/frontend/dist
后端路径：/home/administrator/.openclaw/workspace-main/projects/sm-dating-website/backend

发布前检查清单

执行发布前必须确认：

本地测试通过（npm test / pytest）
数据库结构对比无冲突（scripts/db_diff_check.py）
前端构建成功（npm run build）
回归测试通过率 >90%
已通知相关人员（如需要）

一键发布

使用自动化脚本执行完整发布流程：

cd /home/administrator/.openclaw/workspace-main
python3 skills/prod-deploy/scripts/deploy.py

脚本自动执行：

连接生产服务器
备份当前代码和数据库
上传前端构建文件
上传后端代码
执行数据库迁移（knex migrate:latest）
重启 PM2 服务
验证服务健康状态
输出发布报告

分步执行

1. 数据库备份

ssh root@157.245.56.178 "pg_dump smdating > /tmp/smdating_backup_$(date +%Y%m%d_%H%M%S).dump"

2. 数据库结构对比

python3 scripts/db_diff_check.py

3. 前端构建

cd projects/sm-dating-website/frontend
npm run build

4. 部署前端

python3 scripts/deploy_frontend.py

5. 部署后端

# 使用 SCP 上传后端代码
scp -r projects/sm-dating-website/backend/* root@157.245.56.178:/var/www/sm-dating-website/backend/

6. 执行数据库迁移

ssh root@157.245.56.178 "cd /var/www/sm-dating-website/backend && npm run migrate"

7. 重启服务

ssh root@157.245.56.178 "pm2 restart all"

8. 生产验证

python3 scripts/check_prod_frontend.py
curl -I https://zmq-club.com
curl https://zmq-club.com/api/health

回滚流程

如果发布失败，立即执行回滚：

# 1. 恢复数据库
ssh root@157.245.56.178 "pg_restore -d smdating /tmp/smdating_backup_YYYYMMDD_HHMMSS.dump"

# 2. 恢复代码（从 Git）
ssh root@157.245.56.178 "cd /var/www/sm-dating-website && git reset --hard HEAD~1"

# 3. 重启服务
ssh root@157.245.56.178 "pm2 restart all"

参考文档

references/RELEASE-SOP.md - 完整发布 SOP
references/QUICK-REFERENCE.md - 快速参考

注意事项

⚠️ 发布窗口： 避免在高峰期（20:00-23:00）发布 ⚠️ 备份优先： 任何操作前先备份 ⚠️ 迁移顺序： 先执行 DB 迁移，再重启服务 ⚠️ 验证必须： 发布后必须执行健康检查 ⚠️ 记录发布： 在 memory/YYYY-MM-DD.md 中记录发布内容和时间

常见问题

Q: 数据库迁移失败？ A: 检查 knexfile.js 配置，确认生产数据库连接正常，查看 migrations 文件是否有语法错误。

Q: 前端构建失败？ A: 检查 node_modules 是否完整，尝试 npm ci 重新安装依赖。

Q: PM2 服务启动失败？ A: 查看 pm2 logs 输出，检查 .env 配置文件是否正确，确认端口未被占用。

Q: 回滚后数据丢失？ A: 确认备份文件完整，使用 pg_restore --list 查看备份内容再恢复。

prod-deploy

Safety Notice

Copy this and send it to your AI assistant to learn