升级与发版
升级步骤
- 备份数据库、上传文件和附件目录。
- 阅读 Release 说明,确认是否有数据库变更和需要调整的配置。
- 执行数据库升级脚本(如果有),再替换后端 jar / 镜像和前端静态文件。
- 重启后端;Flowable 的
ACT_*表由引擎自动升级。 - 清理浏览器缓存后登录,检查定时任务、店铺授权状态(渠道接入页面)是否正常。
Docker 部署:
bash
cd docker
# 修改 .env 中的 IMAGE_TAG 为新版本,或拉取新的部署包
docker compose pull && docker compose up -d数据库变更
sql/init.sql是唯一的建表与初始数据脚本,只用于新库(会删除并重建全部表),不要在已有库上执行。- 已有库的增量变更以升级脚本的形式随版本发布(目录
sql/upgrade/<日期>_<名称>.sql),脚本用NOT EXISTS、information_schema判断等方式保证可重复执行,不依赖自增 ID;业务字典数据给平台租户和已有租户各写一份。 - 编写升级脚本后,用「旧版本 init.sql + 升级脚本」与「新版本 init.sql」分别建库,比对表结构和初始数据。
- 直接改库后清理 Redis 中的
login:perms:*(权限)、dict:*(字典)缓存,不要FLUSHALL。
发布新版本
在 GitHub 上发布 Release(标签 vX.Y.Z)后,.github/workflows/release.yml 自动执行:
- 构建后端、前端镜像(
linux/amd64、linux/arm64),推送到ghcr.io/<owner>/lemon-ecom-backend、lemon-ecom-web,标签为版本号、主次版本号和latest; - 构建后端 jar 与前端静态文件,连同
init.sql、Docker 部署包和SHA256SUMS.txt上传到 Release:
| 文件 | 内容 |
|---|---|
lemon-ecom-<版本>.jar | 后端可执行 jar |
lemon-web-<版本>.zip | 前端静态文件 |
init.sql | 新库初始化脚本 |
lemon-ecom-docker-<版本>.zip | 使用 ghcr.io 镜像的 docker-compose、.env.example 与 init.sql |
也可以在 Actions 中手动运行该工作流,填写已有的 Release 标签重新构建。
持续集成
每次推送和 Pull Request 由 .github/workflows/ci.yml 检查:后端 ./gradlew build(含全部测试)与 scripts/check_i18n.py,前端 npm run i18n:check 与 npm run build,小程序 npm run i18n:check 与 npm run build:mp-weixin。