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>
This commit is contained in:
34
deploy/.env.example
Normal file
34
deploy/.env.example
Normal 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
42
deploy/README.md
Normal 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
81
deploy/docker-compose.yml
Normal 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
45
deploy/nginx.conf
Normal 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;
|
||||
}
|
||||
}
|
||||
19
deploy/systemd/eip4-flowable.service
Normal file
19
deploy/systemd/eip4-flowable.service
Normal 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
|
||||
27
deploy/systemd/eip4-platform.service
Normal file
27
deploy/systemd/eip4-platform.service
Normal 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
|
||||
Reference in New Issue
Block a user