diff --git a/deploy/README.md b/deploy/README.md index 54a907e..bf8ed4e 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -1,7 +1,8 @@ -# EIP4 生产部署(A10 MVP:W2 容器化 + W3 nginx 单源 + W4 compose) +# EIP4 生产部署(A10 MVP:W1 Flyway + W2 容器化 + W3 nginx 单源 + W4 compose) > 对应设计 `docs/plans/2026-06-25-A10-生产上线工程化-design.md`。本目录是 **MVP 编排骨架**。 -> ⚠️ **未含 W1 Flyway**:当前 compose 假定 DB 已置备(客户库,或先跑 bootstrap)。从零自举平台表的 Flyway 收敛是下一批次。 +> ✅ **平台表(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。 @@ -24,6 +25,10 @@ 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 时) @@ -31,12 +36,16 @@ docker compose -f deploy/docker-compose.yml logs -f platform-app 见 `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) -- **W1 Flyway**:收敛散落平台表 SQL(含去重 `bootstrap-ai-agent` 两份)为版本化迁移,让 compose 从零自举平台表。 -- **W5**:PG/Flowable 迁移 runbook 在准生产真跑 + 回退验证。 +- **W5**:PG/Flowable 迁移 runbook 在准生产真跑 + 回退验证(含 flowable 引擎库 DDL 置备)。 - **W6**:性能/并发基线 + nginx upstream 权重灰度切流(eip3↔eip4)。 +- **残留收敛**:删除与 `db/migration` 重复的 `bootstrap-*.sql`,把 `ci.sh`/`AiAgentDdlTest`/对拍 fixture 指向 `db/migration`(app 运行态已单源,独立工具仍用 bootstrap)。 -## 验证状态(诚实记录) -- ✅ `docker compose -f deploy/docker-compose.yml --env-file deploy/.env.example config`:编排 + 变量插值 + build context 校验**通过**(4 服务 + 2 卷解析正常)。 -- ⏳ `docker build`(两镜像)**未执行**:本开发机 Docker daemon 未运行(仅 CLI 在)。Dockerfile 已审(JRE21 + 非 root + COPY 预构建 jar glob + 健康探针),但**待在有 daemon 的 dev/CI 真 build 验证**。 -- ⏳ 整栈未起(需置备 DB)。**从零自举平台表需 W1 Flyway(本批次未含)**。 -- 提示:`docker build` 前需先产 jar(步骤 1);`compose --build` 会自动 build。 +## 验证状态(诚实记录,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(含密钥,勿入库)。 diff --git a/deploy/docker-compose.yml b/deploy/docker-compose.yml index 9f19d82..bd9637b 100644 --- a/deploy/docker-compose.yml +++ b/deploy/docker-compose.yml @@ -7,8 +7,9 @@ # 4) 起栈: docker compose -f deploy/docker-compose.yml --env-file deploy/.env up -d --build # # 边界(见 A10 design D2/D6):保真层跑【客户既有 eip3 库】,生产请把 EIP4_DB_URL 指向客户 PG; -# 下面的 postgres 服务仅自测/演示用(空库)。从零自举平台表需 W1 Flyway(本批次未含)—— -# 当前 compose 假定 DB 已置备(客户库 / 或先跑 bootstrap)。 +# 下面的 postgres 服务仅自测/演示用(空库)。平台表(sys_*)由 platform-app 的 W1 Flyway +# 在启动时自建(含自建 eip3 schema);flowable 的 Liquibase 不自建 schema,故演示库经 +# postgres-init/ 预建 eip3+flowable 两 schema(见该脚本注释)。生产指客户库时无需这些。 services: postgres: # D6:仅自测演示;生产用客户 PG,把 EIP4_DB_URL 指过去并删本服务 image: postgres:15 @@ -18,6 +19,7 @@ services: POSTGRES_DB: ${POSTGRES_DB:-eip4} volumes: - pgdata:/var/lib/postgresql/data + - ./postgres-init:/docker-entrypoint-initdb.d:ro # 首次初始化预建 eip3+flowable schema healthcheck: test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-eip4}"] interval: 10s diff --git a/deploy/postgres-init/01-create-schemas.sql b/deploy/postgres-init/01-create-schemas.sql new file mode 100644 index 0000000..6112f3d --- /dev/null +++ b/deploy/postgres-init/01-create-schemas.sql @@ -0,0 +1,12 @@ +-- 内置 postgres 演示服务初始化(A10 W4)。仅在数据卷首次初始化时由 +-- postgres 镜像的 /docker-entrypoint-initdb.d 自动执行一次。 +-- +-- 为何需要:.env.example 把 EIP4_DB_URL / FLOWABLE_JDBC_URL / BIZ_JDBC_URL 指向 +-- currentSchema=eip3 与 currentSchema=flowable。platform-app 的 Flyway 会自建 eip3 +-- 并落平台表;但 flowable-service 的 Liquibase 架构管理器【不会自建 schema】, +-- 缺失即报 "no schema has been selected to create in" 启动崩溃。故演示库在此预建两 schema。 +-- +-- 生产边界(见 A10 design D2/D6):生产把这些 URL 指向【客户既有 PG】, +-- 其 eip3/flowable schema 已存在,无需本脚本;本脚本仅服务内置演示 postgres。 +CREATE SCHEMA IF NOT EXISTS eip3; +CREATE SCHEMA IF NOT EXISTS flowable;