依据《代码结构及框架分析报告》演进建议第 3 项「统一部署编排(容器化)」,为 drama-fusion-platform 落地容器化部署方案。目标:
| 文件 | 大小 | 职责 |
|---|---|---|
| docker/Dockerfile.service | 2.7KB | 通用多阶段构建:maven:3.9-eclipse-temurin-17 编译 → eclipse-temurin:17-jre-alpine 运行;MODULE/SERVICE_PORT 参数化区分 14 个目标服务;含时区、HEALTHCHECK(按端口探测 /actuator/health) |
| docker/docker-compose.yml | 15KB | 全量编排 21 服务:基础设施 + 可观测性 + 14 应用服务;环境变量注入锚点 x-app-environment;depends_on + healthcheck 依赖控制 |
| docker/build.sh | 2.4KB | 一键构建全部/单个服务镜像;内置端口权威表(与 14 个 application.yml 一致) |
| docker/.env.example | 2.2KB | 环境变量模板:开发默认值 + 生产必填密钥占位(fail-closed) |
| docker/README.md | 8KB | 编排拓扑、环境变量机制、构建/启动命令、使用要点 |
| deploy/README.md | — | jar 部署 vs 容器化两种模式总览 |
注:旧 docker/Dockerfile 保留作兼容参考(未重写)。
| 类别 | 服务 | 端口 |
|---|---|---|
| 基础设施 | mysql:8.0 | 3306 |
| redis:7-alpine | 6379 | |
| nacos | 8848 / 9848 | |
| zipkin | 9411 | |
| 应用服务 | drama-gateway | 8080 |
| user-service / content-service / rec-service / ad-service / ai-service | 8101-8105 | |
| trade-service / coin-service / risk-service / payment-service | 8106-8109 | |
| cms-service / asset-service / social-service / audit-service | 8120-8123 | |
| 可观测性 | loki | 3100 |
| promtail | — | |
| grafana | 3000 |
通信拓扑:客户端 → gateway(:8080) → lb:// Nacos 服务发现 → 13 业务服务;服务间经 Nacos 注册、REST/Feign 调用,RocketMQ(可选,默认注释)承载异步。依赖控制:mysql/redis 用 service_healthy,nacos 用 service_started + restart: unless-stopped 自愈。
关键设计:
通过 x-app-environment YAML 扩展 + 锚点(&app-environment)统一注入,应用服务以 <<: *app-environment 继承:
| 环境变量 | 默认值 | 说明 |
|---|---|---|
| SPRING_PROFILES_ACTIVE | prod | 运行环境 |
| NACOS_ADDR | nacos:8848 | 注册/配置中心(compose 服务名) |
| SPRING_DATASOURCE_URL / USERNAME / PASSWORD | mysql:3306 / root / ${MYSQL_ROOT_PASSWORD:-drama_dev_root_2024} | 数据库连接覆盖 |
| SPRING_DATA_REDIS_HOST / PORT | redis / 6379 | Redis 连接 |
| ZIPKIN_URL | http://zipkin:9411/api/v2/spans | 链路追踪上报 |
| LEGACY_RSA_PRIVATE_KEY | ${LEGACY_RSA_PRIVATE_KEY:?required} | 必填、fail-closed(未注入则服务启动失败) |
| AUDIT_SERVICE_URL / JAVA_OPTS / TZ | drama-audit-service:8123 / -Xms256m -Xmx512m / Asia/Shanghai | 审计地址、JVM 参数、时区 |
密钥默认 fail-closed:.env.example 提供开发默认值,生产必须通过 .env 注入真实密钥(LEGACY_RSA_PRIVATE_KEY、WECHAT_APP_SECRET、OPENIM_ADMIN_TOKEN、DEEPSEEK_API_KEY 等)。
| jar 部署(现状) | 容器化(本方案) | |
|---|---|---|
| 启动 | mvn spring-boot:run 逐个手动 | docker compose up -d 一键 |
| 环境 | 依赖本机中间件 | 基础设施同编排 |
| 配置 | application.yml 直读 | 环境变量注入 + fail-closed 密钥 |
| 扩展 | 手动复制进程 | compose scale / 集群化演进 |
| 项 | 结果 |
|---|---|
| YAML 结构解析(services 21 + x-app-environment 锚点) | ✅ 通过(PyYAML 解析 + 锚点合并验证) |
| 锚点继承(gateway env 16 键含 SPRING_PROFILES_ACTIVE 等) | ✅ 通过 |
| build.sh shell 语法(bash -n) | ✅ 通过 |
| 端口映射与 14 个 application.yml 一致性 | ✅ 逐项核对一致 |
| compose 格式缺陷修复(顶层服务键 → services 容器 + 锚点恢复) | ✅ 已修复并验证 |
| docker compose config 实机校验 | ⏳ 待 docker 环境执行 |
实施中发现的缺陷:子代理产出将 compose 服务写成顶层键(无 services 容器)且丢失 x-app-environment 锚点定义,父代理已恢复标准结构并补回锚点块,PyYAML 解析与锚点合并验证通过。