Files
eip4-platform/deploy/README.md
zhengwr 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

43 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
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: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。