Runbook

LiteMall 后台和 API 部署 Runbook

用于部署 LiteMall Spring Boot API、Vue 管理后台、MySQL 和公开展示入口。

怎么执行这份 Runbook

先检查前置条件,再按命令块执行。任何命令都要根据客户环境替换域名、路径、服务名和数据库名,不要复制示例里的占位值直接跑。

部署完成后必须做验证;验证不过就按回滚路径退回,并在交接记录里写清原因。

执行命令

命令是模板,不含真实密钥。执行前必须替换项目名、路径、域名、服务名和数据库名。

后端构建示例

mvn clean package -DskipTests=false
java -jar litemall-all/target/litemall-all-*.jar --spring.profiles.active=prod

后台构建示例

cd litemall-admin
npm install
npm run build

部署后检查

curl -I https://api.example.com/wx/home/index
curl -I https://admin.example.com

前置条件

LiteMall 代码分支、Java/Node/MySQL 版本和数据库脚本已确认。
API 域名、后台域名、Nginx、HTTPS 和备案状态已确认。
演示数据和敏感信息脱敏策略已确认。
备案或 HTTPS 未完成前,不公开正式商城入口。

部署验证

检查 API 能连接 MySQL,并返回首页、分类、商品等核心数据。
检查 Vue 后台能加载、登录、查看商品/订单/配置。
检查 Nginx 分别转发 API 和后台静态资源。
检查公开页面不暴露真实后台账号、支付密钥和订单数据。

回滚路径

保留上一版 jar、后台 dist 包和数据库备份。
API 回滚后重启服务并检查小程序核心接口。
后台回滚后清理浏览器缓存或静态资源缓存。
数据库变更失败时优先按备份恢复,避免半迁移状态。

交接说明

记录代码分支、构建命令、jar 路径、后台 dist 路径和数据库脚本。
记录 API 域名、后台域名、Nginx 配置、HTTPS/备案状态。
明确 mall.liujixue.cn 未恢复 HTTPS 前不得公开写死正式链接。
Contact

部署完成后,记录验证和回滚

部署不是跑完命令就结束。必须记录验证 URL、日志路径、备份位置、回滚命令和未验证风险。

刘鸡血 微信二维码微信扫码添加