Skip to content

升级与发版 ​

升级步骤 ​

  1. 备份数据库、上传文件和附件目录。
  2. 阅读 Release 说明,确认是否有数据库变更和需要调整的配置。
  3. 执行数据库升级脚本(如果有),再替换后端 jar / 镜像和前端静态文件。
  4. 重启后端;Flowable 的 ACT_* 表由引擎自动升级。
  5. 清理浏览器缓存后登录,检查定时任务、店铺授权状态(渠道接入页面)是否正常。

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 自动执行:

  1. 构建后端、前端镜像(linux/amd64、linux/arm64),推送到 ghcr.io/<owner>/lemon-ecom-backend、lemon-ecom-web,标签为版本号、主次版本号和 latest;
  2. 构建后端 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。

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com