flowable-service:8089 无鉴权,裸 proxy_pass 对外会绕过网关超管门匿名部署/覆盖生产BPMN。 前端只经 /api/workflow/ 网关访问流程能力,/flowable/ 改 return 404。 High#2/Medium#3-4 等 A10 生产加固项记入计划 backlog(超管信任模型内可接受)。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
EIP4 生产部署(A10 MVP:W1 Flyway + W2 容器化 + W3 nginx 单源 + W4 compose)
对应设计
docs/plans/2026-06-25-A10-生产上线工程化-design.md。本目录是 MVP 编排骨架。 ✅ 平台表(sys_*)由 W1 Flyway 在 platform-app 启动时自建(含自建eip3schema)——内置演示 postgres 从零即可起平台层,无需先跑 bootstrap。 ℹ️ flowable-service 例外:引擎databaseSchemaUpdate=false是任务红线(严禁引擎自动改表),故其flowableschema 必须【预置备】Flowable 6.8.1 DDL(生产=客户既有 flowable schema)。空演示库无法起 flowable-service,详见下「验证状态」。
拓扑
nginx(单源:serve 前端 dist + 反代 /api→platform-app、/flowable→flowable-service)→ platform-app:8084 + flowable-service:8089 → PostgreSQL。
一、Docker Compose(推荐)
# 1) 产后端 jar
mvn -pl platform-app,flowable-service -am package -DskipTests
# 2) 产前端 dist
( cd ../../eip4-web && npm ci && npm run build )
# 3) 配置(强随机密钥 + DB 指向;生产指客户 PG)
cp deploy/.env.example deploy/.env && $EDITOR deploy/.env
# 4) 起栈
docker compose -f deploy/docker-compose.yml --env-file deploy/.env up -d --build
# 健康/日志
docker compose -f deploy/docker-compose.yml ps
docker compose -f deploy/docker-compose.yml logs -f platform-app
生产数据库(D2/D6):保真层跑在客户既有 eip3 库上,EIP4 只新增平台表。生产请把 .env 的 EIP4_DB_URL 指向客户 PG,并可删除 compose 内置 postgres 服务(仅自测演示用空库)。
内置演示库 schema(W4):.env.example 用 currentSchema=eip3 / currentSchema=flowable。platform-app 的 Flyway 会自建 eip3 并落平台表;但 flowable 的 Liquibase 不自建 schema,故内置 postgres 经 deploy/postgres-init/01-create-schemas.sql 在首次初始化预建 eip3+flowable 两 schema。生产指客户库时这些 schema 已存在,无需 init 脚本。
flowable-service 引擎库:databaseSchemaUpdate=false(任务红线)→ 引擎不自建 ACT_/FLW_ 表。空 flowable schema 启动会报 relation "flw_channel_definition" does not exist。要起 flowable-service 需先把 Flowable 6.8.1 引擎 DDL 灌入 flowable schema(生产=客户既有引擎库;演示如需自洽可把对应 create SQL 追加到 postgres-init/)。
密钥(D4):EIP4_AUTH_JWT_SECRET 等敏感项 application-prod.yml 无默认值,缺失即启动失败(fail-safe)。用 openssl rand -base64 48 生成。
二、systemd 裸 jar(D3 兜底:客户禁 Docker 时)
见 deploy/systemd/*.service 头部安装说明:jar→/opt/eip4/,env→/etc/eip4/*.env(chmod 600),systemctl enable --now。前端 dist 用宿主 nginx serve(参考 deploy/nginx.conf,upstream 改为 127.0.0.1:8084/8089)。
三、待办(后续批次,见 A10 design)
- W5:PG/Flowable 迁移 runbook 在准生产真跑 + 回退验证(含 flowable 引擎库 DDL 置备)。
- W6:性能/并发基线 + nginx upstream 权重灰度切流(eip3↔eip4)。
✅ 残留收敛已完成(2026-06-25):与
db/migration重复的 3 份bootstrap-*.sql(page-schema/datastatus/ai-agent)已删;ci.sh改指db/migration/V1;AiAgentDdlTest迁入 platform-app 守 V3;SchemaImportCli内联 DDL 经PlatformMigrationDdlGuardTest钉死 ≡ V1。db/migration 为平台表 DDL 唯一真相。
验证状态(诚实记录,2026-06-25 本地真验)
- ✅
docker build两镜像通过:platform-app727MB /flowable641MB(JRE21 + 非 root + COPY 预构建 jar)。 - ✅ 整栈
docker compose up对内置空 postgres 真起(本地 Docker daemon + PG 15.15):- platform-app 在 prod profile 下启动,W1 Flyway 在 Spring Boot 启动时自建
eip3schema 并应用 V1-V3(9 张 sys_* 表,flyway_schema_historyv1/v2/v3 全 success);/actuator/health/readiness={"status":"UP"}。 - nginx 单源验证:
GET /→ 200 SPA;/api/meta/entities经反代到 platform-app → 401(prod 严格认证链生效,印证 P0 fail-safe 修复在运行态成立)。 - postgres-init 预建 schema 生效:
no schema has been selected报错消除。
- platform-app 在 prod profile 下启动,W1 Flyway 在 Spring Boot 启动时自建
- ⚠️ flowable-service 在空演示库无法起(by design):引擎
databaseSchemaUpdate=false红线 → 不自建表,空flowableschema 报flw_channel_definition does not exist。生产用客户既有引擎库即正常;演示自洽需向postgres-init/追加 Flowable 6.8.1 DDL。 - ℹ️ 登录
/api/auth/login在空演示库返 401 属预期(无客户 SYS_USER 数据);保真层业务端点同理需客户数据。 - 提示:
docker build前需先产 jar(步骤 1);compose --build会自动 build。.env已 gitignore(含密钥,勿入库)。