Files
eip4-platform/deploy/README.md
zhengwr fa3c92b698 chore(A10 W1): 收敛重复 bootstrap,db/migration 成平台表 DDL 单一真相
W1 引入 db/migration/V1-V3 后,平台表 DDL 在迁移与各模块 bootstrap-*.sql 重复
(评审揪出的"易漂移")。本次收敛,db/migration 成唯一真相:

- 删 3 份重复 bootstrap:bootstrap-page-schema(=V1)/bootstrap-datastatus(=V2)/
  bootstrap-ai-agent(=V3)。三者无运行态 classpath 消费者(已全仓核实)。
- AiAgentDdlTest(platform-ai,原读 bootstrap-ai-agent.sql)删除,等价覆盖迁入
  platform-app 新增 PlatformMigrationDdlGuardTest:① 守 V3 声明全部 AI 平台表/索引;
  ② 守 SchemaImportCli.CREATE_DDL ≡ V1(独立 CLI 兜底 DDL 防漂移)。
- SchemaImportCli.CREATE_DDL 由包私有改 public 供上述 guard 比对;两处过时注释改指 V1。
- ci.sh 平台表预灌改指 db/migration/V1(注:app 启动 Flyway 已幂等建表,此预灌仅冗余兜底)。
- docs 对齐:AI_AGENT_AUTO_DEVELOPMENT(spring.sql.init→Flyway)、docs/sql/SYS_PAGE_SCHEMA
  /SYS_AI_AGENT 头注释(待办→已落地)、A10 design 残留收敛标完成、deploy/README 残留项标完成。

边界:platform-parity 的 bootstrap-{sys,privilege,auth,xservice,multidim,flow}.sql 是
eip3 schema 对拍测试 fixture,非平台表副本,原样保留。

验证:全 reactor mvn clean install 绿;PlatformMigrationDdlGuardTest 2/2;独立 code-reviewer
评审 GO(零 CRITICAL/HIGH/MEDIUM,含 guard substring 逻辑对真实 V1 仿真核实)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 15:16:35 +08:00

53 lines
4.8 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# EIP4 生产部署(A10 MVP:W1 Flyway + W2 容器化 + W3 nginx 单源 + W4 compose)
> 对应设计 `docs/plans/2026-06-25-A10-生产上线工程化-design.md`。本目录是 **MVP 编排骨架**。
> ✅ **平台表(sys_*)由 W1 Flyway 在 platform-app 启动时自建**(含自建 `eip3` schema)——内置演示 postgres 从零即可起平台层,无需先跑 bootstrap。
> ℹ️ **flowable-service 例外**:引擎 `databaseSchemaUpdate=false` 是任务红线(严禁引擎自动改表),故其 `flowable` schema 必须【预置备】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(推荐)
```bash
# 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-app` 727MB / `flowable` 641MB(JRE21 + 非 root + COPY 预构建 jar)。
- ✅ **整栈 `docker compose up` 对内置空 postgres 真起**(本地 Docker daemon + PG 15.15):
- platform-app 在 **prod profile** 下启动,**W1 Flyway 在 Spring Boot 启动时自建 `eip3` schema 并应用 V1-V3**(9 张 sys_* 表,`flyway_schema_history` v1/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` 报错消除。
- ⚠️ **flowable-service 在空演示库无法起**(by design):引擎 `databaseSchemaUpdate=false` 红线 → 不自建表,空 `flowable` schema 报 `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(含密钥,勿入库)。