P3-3: Flowable 5.13-SNAPSHOT→6.8.1 升级工具链产品化 + 演练全绿

一键链(tools/flowable-upgrade/):
  ①前置校验→②版本串规范化→③Flowable 5.23→④6.8.1 兼容层→⑤后置校验
  全步骤幂等可重入;参数化 host/port/db/schema;JAVA_HOME 强制传 Maven。

完整重演(eip4flow_rehearsal,客户库只读口径):
  import_5x 63s | 一键链 21s | 后置全绿
  1515 定义 / 9386 执行 / 9324 任务 / 26761 历史 全量就地保留
  schema.version: 5.13-SNAPSHOT → 5.23.0.0 → 6.8.1.0
  engineVer=v5 标记: 1515/1515

迁移手册新增坑6.4: Maven exec:java 在多 JDK 环境不走脚本 JAVA_HOME。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 14:31:29 +08:00
parent 6cc7b3fb61
commit 3b59e90504
13 changed files with 557 additions and 1 deletions

View File

@@ -0,0 +1,27 @@
#!/usr/bin/env bash
# 02_normalize.sh —— ② 版本串规范化 5.13-SNAPSHOT → 5.13(坑6.1)
# 根因:Flowable 5.x 升级链以 act_ge_property.schema.version 匹配版本范围,
# SNAPSHOT 串不在范围内 -> "unknown version from database",整链中断。
# 幂等:已是 5.13 则跳过;UPDATE ... WHERE value_='5.13-SNAPSHOT' 天然幂等。
set -euo pipefail
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "${HERE}/common.sh"
log "② 版本串规范化(5.13-SNAPSHOT → 5.13)"
begin_timer
VER=$(tpsql -tA -c "SELECT value_ FROM ${TGT_SCHEMA}.act_ge_property WHERE name_='schema.version'")
if [ "${VER}" = "5.13" ]; then
ok "已是 5.13,无需规范化(幂等跳过)"
elif [ "${VER}" = "5.13-SNAPSHOT" ]; then
n=$(tpsql -tA -c "UPDATE ${TGT_SCHEMA}.act_ge_property SET value_='5.13' WHERE name_='schema.version' AND value_='5.13-SNAPSHOT'; SELECT 1")
NEW=$(tpsql -tA -c "SELECT value_ FROM ${TGT_SCHEMA}.act_ge_property WHERE name_='schema.version'")
[ "${NEW}" = "5.13" ] || die "规范化后版本串仍为 ${NEW}"
ok "schema.version: 5.13-SNAPSHOT -> 5.13"
else
# 非 5.13 系(可能已升级或非预期):不擅动,交人工。
warn "当前版本串 ${VER} 非 5.13-SNAPSHOT,本步不修改;若已 v5/v6 可继续后续步骤"
fi
end_timer "02_normalize"
log "② 规范化完成,可启动 Flowable 5.23 升级"