DRAMA 融合短剧平台 — 容器化编排部署实施报告

Containerization & Orchestration Implementation Report — docker/ 编排落地(develop @ a0f549b)
报告日期:2026-08-09 版本:v1.0 状态:已合入 develop(PR #32) 范围:21 服务编排 · 6 个交付文件

一、背景与目标

依据《代码结构及框架分析报告》演进建议第 3 项「统一部署编排(容器化)」,为 drama-fusion-platform 落地容器化部署方案。目标:

二、交付文件清单

文件大小职责
docker/Dockerfile.service2.7KB通用多阶段构建:maven:3.9-eclipse-temurin-17 编译 → eclipse-temurin:17-jre-alpine 运行;MODULE/SERVICE_PORT 参数化区分 14 个目标服务;含时区、HEALTHCHECK(按端口探测 /actuator/health)
docker/docker-compose.yml15KB全量编排 21 服务:基础设施 + 可观测性 + 14 应用服务;环境变量注入锚点 x-app-environment;depends_on + healthcheck 依赖控制
docker/build.sh2.4KB一键构建全部/单个服务镜像;内置端口权威表(与 14 个 application.yml 一致)
docker/.env.example2.2KB环境变量模板:开发默认值 + 生产必填密钥占位(fail-closed)
docker/README.md8KB编排拓扑、环境变量机制、构建/启动命令、使用要点
deploy/README.md—jar 部署 vs 容器化两种模式总览

注:旧 docker/Dockerfile 保留作兼容参考(未重写)。

三、编排拓扑(21 服务)

类别服务端口
基础设施mysql:8.03306
redis:7-alpine6379
nacos8848 / 9848
zipkin9411
应用服务drama-gateway8080
user-service / content-service / rec-service / ad-service / ai-service8101-8105
trade-service / coin-service / risk-service / payment-service8106-8109
cms-service / asset-service / social-service / audit-service8120-8123
可观测性loki3100
promtail—
grafana3000

通信拓扑:客户端 → gateway(:8080) → lb:// Nacos 服务发现 → 13 业务服务;服务间经 Nacos 注册、REST/Feign 调用,RocketMQ(可选,默认注释)承载异步。依赖控制:mysql/redis 用 service_healthy,nacos 用 service_started + restart: unless-stopped 自愈。

四、镜像构建方案(Dockerfile.service)

# 构建阶段 FROM maven:3.9-eclipse-temurin-17 AS build ARG MODULE RUN mvn -B -pl ${MODULE} -am clean package -DskipTests # 运行阶段 FROM eclipse-temurin:17-jre-alpine ARG MODULE ARG SERVICE_PORT=8080 ENV SERVICE_PORT=${SERVICE_PORT} ENV JAVA_OPTS="-Xms256m -Xmx512m" EXPOSE ${SERVICE_PORT} HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=3 \ CMD wget -qO- http://127.0.0.1:${SERVICE_PORT}/actuator/health || exit 1

关键设计:

五、配置注入机制

通过 x-app-environment YAML 扩展 + 锚点(&app-environment)统一注入,应用服务以 <<: *app-environment 继承:

环境变量默认值说明
SPRING_PROFILES_ACTIVEprod运行环境
NACOS_ADDRnacos:8848注册/配置中心(compose 服务名)
SPRING_DATASOURCE_URL / USERNAME / PASSWORDmysql:3306 / root / ${MYSQL_ROOT_PASSWORD:-drama_dev_root_2024}数据库连接覆盖
SPRING_DATA_REDIS_HOST / PORTredis / 6379Redis 连接
ZIPKIN_URLhttp://zipkin:9411/api/v2/spans链路追踪上报
LEGACY_RSA_PRIVATE_KEY${LEGACY_RSA_PRIVATE_KEY:?required}必填、fail-closed(未注入则服务启动失败)
AUDIT_SERVICE_URL / JAVA_OPTS / TZdrama-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 等)。

六、部署步骤

完整启动(构建全部镜像 + 拉起编排)

cd docker cp .env.example .env # 按需修改生产密钥 docker compose config # 语法校验(推荐先执行) docker compose up -d --build

单服务镜像构建

bash docker/build.sh drama-user-service # 仅构建 user-service 镜像 bash docker/build.sh # 构建全部 14 个应用服务镜像

与 jar 部署方式对比

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 解析与锚点合并验证通过。

八、风险与遗留事项