Compare commits

..

2 Commits

Author SHA1 Message Date
97a0eb12ae Merge feat/a10-mvp-containerization: A10 MVP W2-W4 部署骨架
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 14:05:56 +08:00
ade4c928bb feat(deploy): A10 MVP W2-W4 容器化+nginx 单源+compose 编排骨架
platform-app/flowable-service Dockerfile(JRE21+非root+COPY 预构建 jar+健康探针);deploy/nginx.conf(单源:serve dist+反代 /api、/flowable);deploy/docker-compose.yml(4服务 postgres+platform-app+flowable-service+nginx,healthcheck/depends_on);deploy/.env.example(prod 密钥/DB env,fail-fast);deploy/systemd/*(D3 禁Docker客户兜底);deploy/README.md。验证:docker compose config 通过(4服务+插值);docker build 待 daemon(本机未起,已诚实标注)。验证揪修 flowable-service 双数据源 FLOWABLE_JDBC_*/BIZ_JDBC_* env 漏传。.gitignore 加 deploy/.env。W1 Flyway 下一批次:当前 compose 假定 DB 已置备,尚不能从零自举。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 14:05:56 +08:00
10 changed files with 305 additions and 0 deletions

3
.gitignore vendored
View File

@@ -28,3 +28,6 @@ tools/s3_rewriter/output/分级清单.csv
# Office 临时锁文件 / 系统垃圾
~$*
.DS_Store
# A10 部署本地密钥(只提交 .env.example)
deploy/.env

34
deploy/.env.example Normal file
View File

@@ -0,0 +1,34 @@
# EIP4 生产编排环境变量样例(A10 W4)。复制为 deploy/.env 并改成真值;.env 切勿入库。
#
# cp deploy/.env.example deploy/.env
# ── 安全(必填,application-prod.yml 无默认,缺失即 fail-fast)──────────────────
# JWT 签名密钥:强随机 ≥32 字节。生成: openssl rand -base64 48
EIP4_AUTH_JWT_SECRET=CHANGE_ME_strong_random_at_least_32_bytes_0123456789abcdef
# ── 数据库 ───────────────────────────────────────────────────────────────────
# 生产:指向【客户既有 eip3 库】(保真层在其上运行,EIP4 只新增平台表)。
# 自测/演示:用内置 postgres 服务 → jdbc:postgresql://postgres:5432/eip4?currentSchema=eip3
EIP4_DB_URL=jdbc:postgresql://postgres:5432/eip4?currentSchema=eip3
EIP4_DB_USERNAME=eip4
EIP4_DB_PASSWORD=eip4
# 内置 postgres 服务凭据(仅自测演示用;生产用客户 PG 时可删 postgres 服务并忽略这三项)
POSTGRES_USER=eip4
POSTGRES_PASSWORD=eip4
POSTGRES_DB=eip4
# ── flowable-service 双数据源(env 驱动)────────────────────────────────────────
# ACT_ 工作流引擎库(Flowable 运行时表);生产指客户 PG 的 flowable schema
FLOWABLE_JDBC_URL=jdbc:postgresql://postgres:5432/eip4?currentSchema=flowable
FLOWABLE_JDBC_USER=eip4
FLOWABLE_JDBC_PASS=eip4
# biz 客户业务库(只读,候选人/组织解析直查 SYS_* 组织表);生产指客户 eip3 库
BIZ_JDBC_URL=jdbc:postgresql://postgres:5432/eip4?currentSchema=eip3
BIZ_JDBC_USER=eip4
BIZ_JDBC_PASS=eip4
# ── 单源托管 ─────────────────────────────────────────────────────────────────
HTTP_PORT=80
# 前端构建产物路径(相对 deploy/docker-compose.yml);先 `cd eip4-web && npm run build` 生成
WEB_DIST=../../eip4-web/dist

42
deploy/README.md Normal file
View File

@@ -0,0 +1,42 @@
# EIP4 生产部署(A10 MVP:W2 容器化 + W3 nginx 单源 + W4 compose)
> 对应设计 `docs/plans/2026-06-25-A10-生产上线工程化-design.md`。本目录是 **MVP 编排骨架**。
> ⚠️ **未含 W1 Flyway**:当前 compose 假定 DB 已置备(客户库,或先跑 bootstrap)。从零自举平台表的 Flyway 收敛是下一批次。
## 拓扑
`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` 服务(仅自测演示用空库)。
**密钥(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)
- **W1 Flyway**:收敛散落平台表 SQL(含去重 `bootstrap-ai-agent` 两份)为版本化迁移,让 compose 从零自举平台表。
- **W5**:PG/Flowable 迁移 runbook 在准生产真跑 + 回退验证。
- **W6**:性能/并发基线 + nginx upstream 权重灰度切流(eip3↔eip4)。
## 验证状态(诚实记录)
- ✅ `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。

81
deploy/docker-compose.yml Normal file
View File

@@ -0,0 +1,81 @@
# EIP4 生产编排骨架(A10 W4)。四服务:nginx 单源 + platform-app + flowable-service + postgres。
#
# 用法(见 deploy/README.md):
# 1) 先产 jar: mvn -pl platform-app,flowable-service -am package -DskipTests
# 2) 先产前端: (cd ../../eip4-web && npm ci && npm run build) # 生成 eip4-web/dist
# 3) 配 .env: cp deploy/.env.example deploy/.env && 改强随机密钥/DB
# 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)。
services:
postgres: # D6:仅自测演示;生产用客户 PG,把 EIP4_DB_URL 指过去并删本服务
image: postgres:15
environment:
POSTGRES_USER: ${POSTGRES_USER:-eip4}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-eip4}
POSTGRES_DB: ${POSTGRES_DB:-eip4}
volumes:
- pgdata:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-eip4}"]
interval: 10s
timeout: 5s
retries: 12
networks: [eip4]
platform-app:
build:
context: ../platform-app
environment:
SPRING_PROFILES_ACTIVE: prod
SERVER_PORT: 8084
EIP4_AUTH_JWT_SECRET: ${EIP4_AUTH_JWT_SECRET} # 强制(application-prod.yml 无默认,缺失 fail-fast)
EIP4_DB_URL: ${EIP4_DB_URL}
EIP4_DB_USERNAME: ${EIP4_DB_USERNAME}
EIP4_DB_PASSWORD: ${EIP4_DB_PASSWORD}
EIP4_FILE_ROOT: /data/files
volumes:
- filedata:/data/files
depends_on:
postgres:
condition: service_healthy
networks: [eip4]
restart: unless-stopped
flowable-service:
build:
context: ../flowable-service
environment:
SERVER_PORT: 8089
# flowable-service 双数据源(env 驱动):ACT_ 引擎库 + biz 客户库(候选人解析直查组织表)
FLOWABLE_JDBC_URL: ${FLOWABLE_JDBC_URL}
FLOWABLE_JDBC_USER: ${FLOWABLE_JDBC_USER}
FLOWABLE_JDBC_PASS: ${FLOWABLE_JDBC_PASS}
BIZ_JDBC_URL: ${BIZ_JDBC_URL}
BIZ_JDBC_USER: ${BIZ_JDBC_USER}
BIZ_JDBC_PASS: ${BIZ_JDBC_PASS}
depends_on:
postgres:
condition: service_healthy
networks: [eip4]
restart: unless-stopped
nginx: # 单源:serve 前端 dist + 反代 /api、/flowable
image: nginx:alpine
ports:
- "${HTTP_PORT:-80}:80"
volumes:
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
- ${WEB_DIST:-../../eip4-web/dist}:/usr/share/nginx/html:ro
depends_on: [platform-app, flowable-service]
networks: [eip4]
restart: unless-stopped
volumes:
pgdata:
filedata:
networks:
eip4:

45
deploy/nginx.conf Normal file
View File

@@ -0,0 +1,45 @@
# EIP4 单源托管(A10 W3)。挂载为 nginx:alpine 的 /etc/nginx/conf.d/default.conf。
# 一个源:静态 SPA(eip4-web/dist)+ 反代 /api→platform-app、/flowable→flowable-service。
# 消除 dev 的 vite proxy 依赖;切流灰度(W6)可在此用 upstream 权重双跑(eip3↔eip4)。
server {
listen 80;
server_name _;
# 附件上传/导出:放宽请求体上限(与保真层附件大小对齐,按需调)
client_max_body_size 50m;
gzip on;
gzip_types text/css application/javascript application/json image/svg+xml;
gzip_min_length 1024;
# 后端 REST(现代层 + 保真层引擎)
location /api/ {
proxy_pass http://platform-app:8084;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 130s; # 略大于 statement_timeout(120s),避免反代先于 DB 超时切断
}
# 工作流引擎(按需直达;多数流程经 platform-app 网关,故默认收窄)
location /flowable/ {
proxy_pass http://flowable-service:8089/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
# 静态资源:带 hash 的构建产物可长缓存
location /assets/ {
root /usr/share/nginx/html;
expires 7d;
add_header Cache-Control "public, immutable";
}
# SPA:其余路由回退 index.html(amis 前端 history 路由)
location / {
root /usr/share/nginx/html;
try_files $uri $uri/ /index.html;
}
}

View File

@@ -0,0 +1,19 @@
# EIP4 flowable-service systemd 单元(A10 W4·D3 兜底)。
# 安装同 eip4-platform.service:jar→/opt/eip4/flowable-service.jar,env→/etc/eip4/flowable.env。
[Unit]
Description=EIP4 flowable-service
After=network-online.target
Wants=network-online.target
[Service]
User=eip4
Group=eip4
EnvironmentFile=/etc/eip4/flowable.env
Environment=SPRING_PROFILES_ACTIVE=prod
ExecStart=/usr/bin/java -jar /opt/eip4/flowable-service.jar
SuccessExitStatus=143
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target

View File

@@ -0,0 +1,27 @@
# EIP4 platform-app systemd 单元(A10 W4·D3 兜底:禁 Docker 的客户用裸 jar + systemd)。
# 安装:
# sudo cp platform-app/target/platform-app-*.jar /opt/eip4/platform-app.jar
# sudo install -d -o eip4 -g eip4 /opt/eip4 /var/lib/eip4/files
# sudo cp deploy/.env.example /etc/eip4/platform.env # 改成真值,chmod 600
# sudo cp deploy/systemd/eip4-platform.service /etc/systemd/system/
# sudo systemctl daemon-reload && sudo systemctl enable --now eip4-platform
[Unit]
Description=EIP4 platform-app
After=network-online.target
Wants=network-online.target
[Service]
User=eip4
Group=eip4
# /etc/eip4/platform.env 提供 EIP4_AUTH_JWT_SECRET / EIP4_DB_* / SERVER_PORT 等(chmod 600)
EnvironmentFile=/etc/eip4/platform.env
Environment=SPRING_PROFILES_ACTIVE=prod
Environment=EIP4_FILE_ROOT=/var/lib/eip4/files
# JDK21 路径按宿主调整
ExecStart=/usr/bin/java -jar /opt/eip4/platform-app.jar
SuccessExitStatus=143
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target

View File

@@ -3,6 +3,8 @@
> 目标读者:拍板人 + 执行者。本文是**待拍板设计**,不是已实现记录。对应进度总览 §3 A10(🔴 未起步)、§5 P2#9、§10.2「生产交付能力缺口」。
> 定位:把「dev 能跑」推进到「客户环境可交付、可回滚、可观测」。**纯设计产出,不依赖运行环境**;落地需用户环境(真 DB / 容器宿主 / Gitea runner)。
> **🛠️ 实施进度(2026-06-25)**:**W2+W3+W4 MVP 骨架已落地**(按推荐默认 D1 nginx 单源 / D3 compose+systemd 双轨 / D4 env / D6 客户 PG)——`platform-app/Dockerfile`、`flowable-service/Dockerfile`、`deploy/{nginx.conf,docker-compose.yml,.env.example,README.md,systemd/*.service}`。验证:`docker compose config` 通过(4 服务 + 变量插值);**`docker build` 待有 daemon 的 dev/CI 真验**(本机 daemon 未起)。验证过程揪出并修:flowable-service 双数据源(FLOWABLE_JDBC_*/BIZ_JDBC_*)env 漏传已补。**W1 Flyway 未做(下一批次)→ 当前 compose 假定 DB 已置备,尚不能从零自举平台表**。W5/W6 需准生产。
## 0. 一句话
EIP4 当前只有 **dev 形态**(手工 `run-dev.sh` 起两个 fat jar + 前端 vite proxy)。生产化缺四块成体系交付物:**① Flyway 平台表迁移 ② 容器化/编排(compose+Dockerfile+nginx)③ 单源托管与切流回滚 ④ 数据迁移 runbook 执行 + 性能/灰度基线**。可观测性(actuator+logback)与安全基线(prod profile/JWT/CI)本月已补,是 A10 的前置已就位。

View File

@@ -0,0 +1,21 @@
# flowable-service 生产镜像(A10 W2)。
# 前置:先 `mvn -pl flowable-service -am package -DskipTests` 产出 fat jar(见 deploy/README.md)。
FROM eclipse-temurin:21-jre
WORKDIR /app
COPY target/flowable-service-*.jar /app/app.jar
RUN useradd -r -u 10002 eip4flw \
&& chown -R 10002:10002 /app
USER 10002
ENV SPRING_PROFILES_ACTIVE=prod \
SERVER_PORT=8089 \
JAVA_OPTS=""
EXPOSE 8089
# flowable-service 未配 actuator,健康探针用 TCP 端口可达(bash /dev/tcp,temurin 基础镜像自带 bash)。
HEALTHCHECK --interval=15s --timeout=5s --start-period=90s --retries=12 \
CMD bash -c "echo > /dev/tcp/127.0.0.1/${SERVER_PORT}" || exit 1
ENTRYPOINT ["sh", "-c", "exec java $JAVA_OPTS -jar /app/app.jar"]

31
platform-app/Dockerfile Normal file
View File

@@ -0,0 +1,31 @@
# platform-app 生产镜像(A10 W2)。
# 前置:先 `mvn -pl platform-app -am package -DskipTests` 产出 fat jar(见 deploy/README.md)。
# 设计:slim JRE21 运行层 + 非 root + prod profile;敏感配置经环境变量注入(application-prod.yml 强制,缺失即 fail-fast)。
FROM eclipse-temurin:21-jre
# curl 仅供容器健康探针打 /actuator/health(application-prod.yml 暴露,匿名可见 UP/DOWN)
RUN apt-get update \
&& apt-get install -y --no-install-recommends curl \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /app
# 版本无关 glob,避免随 version 变更改 Dockerfile
COPY target/platform-app-*.jar /app/app.jar
# 非 root 运行 + 附件根目录(EIP4_FILE_ROOT 默认指向此)
RUN useradd -r -u 10001 eip4 \
&& mkdir -p /data/files \
&& chown -R 10001:10001 /app /data
USER 10001
ENV SPRING_PROFILES_ACTIVE=prod \
EIP4_FILE_ROOT=/data/files \
SERVER_PORT=8084 \
JAVA_OPTS=""
EXPOSE 8084
# 真健康探针:actuator readiness(DB 等组件就绪才 UP);start-period 给保真层引擎自举留足时间。
HEALTHCHECK --interval=15s --timeout=5s --start-period=90s --retries=12 \
CMD curl -fsS "http://127.0.0.1:${SERVER_PORT}/actuator/health/readiness" || exit 1
ENTRYPOINT ["sh", "-c", "exec java $JAVA_OPTS -jar /app/app.jar"]