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,63 @@
#!/usr/bin/env bash
# flowable_upgrade.sh —— EIP3 Flowable 5.13-SNAPSHOT → 6.8.1 一键升级链(产品化)
#
# 链路: ① 前置校验 → ② 版本串规范化 → ③ Flowable 5.23 升级 → ④ 6.8.1 兼容层升级 → ⑤ 后置校验
# 每步幂等可重入;失败统一回退点 = 备份 A(源库物理冷备,本链只升 schema/不删业务数据)。
#
# 用法:
# ./flowable_upgrade.sh [选项] [步骤...]
# 选项(参数化连接;亦可用同名环境变量):
# --host H 目标库主机 (默认 localhost)
# --port P 目标库端口 (默认 5433)
# --db D 目标库名 (默认 eip4flow_rehearsal)
# --schema S 目标 schema (默认 eip3)
# --user U 目标库用户 (默认 当前系统用户)
# --pass P 目标库口令 (默认 空)
# --assume-backed-up 跳过备份交互确认(演练/CI)
# 步骤(缺省=全链 1..5):可指定子集,如 `1 2` 或 `5`,数字对应链路序号。
#
# 示例:
# 演练全链: ./flowable_upgrade.sh --db eip4flow_rehearsal --assume-backed-up
# 仅后置校验:./flowable_upgrade.sh --db eip4flow_rehearsal 5
set -euo pipefail
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
STEPS=()
while [ $# -gt 0 ]; do
case "$1" in
--host) export TGT_HOST="$2"; shift 2;;
--port) export TGT_PORT="$2"; shift 2;;
--db) export TGT_DB="$2"; shift 2;;
--schema) export TGT_SCHEMA="$2"; shift 2;;
--user) export TGT_USER="$2"; shift 2;;
--pass) export TGT_PASS="$2"; shift 2;;
--assume-backed-up) export ASSUME_BACKED_UP=1; shift;;
-h|--help) sed -n '2,30p' "$0"; exit 0;;
[1-5]) STEPS+=("$1"); shift;;
*) echo "未知参数: $1"; exit 2;;
esac
done
[ ${#STEPS[@]} -eq 0 ] && STEPS=(1 2 3 4 5)
source "${HERE}/lib/common.sh"
: > "${WORK_DIR}/timings.tsv" # 重置本次计时
# 步骤号 -> 脚本(bash 3.2 兼容,不用关联数组)
step_file() {
case "$1" in
1) echo "01_precheck.sh";; 2) echo "02_normalize.sh";; 3) echo "03_upgrade_v5.sh";;
4) echo "04_upgrade_v6.sh";; 5) echo "05_postcheck.sh";;
esac
}
log "===== Flowable 升级一键链 | 目标 ${TGT_HOST}:${TGT_PORT}/${TGT_DB}.${TGT_SCHEMA} | 步骤 ${STEPS[*]} ====="
CHAIN_T0=$(date +%s)
for s in "${STEPS[@]}"; do
bash "${HERE}/lib/$(step_file "$s")"
done
CHAIN_DT=$(( $(date +%s) - CHAIN_T0 ))
echo
log "===== 一键链完成,总耗时 ${CHAIN_DT}s ====="
log "分步耗时:"
column -t -s $'\t' "${WORK_DIR}/timings.tsv" | sed 's/^/ /'