diff --git a/.gitignore b/.gitignore index 4fde07c..d7abbe1 100644 --- a/.gitignore +++ b/.gitignore @@ -28,3 +28,6 @@ tools/s3_rewriter/output/分级清单.csv # Office 临时锁文件 / 系统垃圾 ~$* .DS_Store + +# A10 部署本地密钥(只提交 .env.example) +deploy/.env diff --git a/deploy/.env.example b/deploy/.env.example new file mode 100644 index 0000000..334bf7b --- /dev/null +++ b/deploy/.env.example @@ -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 diff --git a/deploy/README.md b/deploy/README.md new file mode 100644 index 0000000..54a907e --- /dev/null +++ b/deploy/README.md @@ -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。 diff --git a/deploy/docker-compose.yml b/deploy/docker-compose.yml new file mode 100644 index 0000000..9f19d82 --- /dev/null +++ b/deploy/docker-compose.yml @@ -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: diff --git a/deploy/nginx.conf b/deploy/nginx.conf new file mode 100644 index 0000000..16d1665 --- /dev/null +++ b/deploy/nginx.conf @@ -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; + } +} diff --git a/deploy/systemd/eip4-flowable.service b/deploy/systemd/eip4-flowable.service new file mode 100644 index 0000000..4e910a3 --- /dev/null +++ b/deploy/systemd/eip4-flowable.service @@ -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 diff --git a/deploy/systemd/eip4-platform.service b/deploy/systemd/eip4-platform.service new file mode 100644 index 0000000..e34dc03 --- /dev/null +++ b/deploy/systemd/eip4-platform.service @@ -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 diff --git a/docs/plans/2026-06-25-A10-生产上线工程化-design.md b/docs/plans/2026-06-25-A10-生产上线工程化-design.md index a2ef096..8a62bc6 100644 --- a/docs/plans/2026-06-25-A10-生产上线工程化-design.md +++ b/docs/plans/2026-06-25-A10-生产上线工程化-design.md @@ -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 的前置已就位。 diff --git a/flowable-service/Dockerfile b/flowable-service/Dockerfile new file mode 100644 index 0000000..b87b1b0 --- /dev/null +++ b/flowable-service/Dockerfile @@ -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"] diff --git a/platform-app/Dockerfile b/platform-app/Dockerfile new file mode 100644 index 0000000..3c14f29 --- /dev/null +++ b/platform-app/Dockerfile @@ -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"]