88 lines
3.6 KiB
Markdown
88 lines
3.6 KiB
Markdown
|
polaris-wvp 构建流程详解
|
|||
|
|
这是一个多阶段构建（Multi-stage Build）的 Dockerfile，分为两个阶段：
|
|||
|
|
|
|||
|
|
第一阶段：Builder（构建阶段）
|
|||
|
|
基础镜像
|
|||
|
|
FROM ringcentral/jdk:11 AS builder
|
|||
|
|
使用 ringcentral/jdk:11 作为构建基础镜像
|
|||
|
|
命名为 builder 阶段，供后续引用
|
|||
|
|
端口声明
|
|||
|
|
EXPOSE 18978/tcp # WVP Web 管理端口
|
|||
|
|
EXPOSE 8116/tcp # SIP 信令端口（TCP）
|
|||
|
|
EXPOSE 8116/udp # SIP 信令端口（UDP）
|
|||
|
|
EXPOSE 8080/tcp # HTTP 端口
|
|||
|
|
安装 Maven
|
|||
|
|
RUN apt-get update && \
|
|||
|
|
apt-get install -y maven && \
|
|||
|
|
rm -rf /var/lib/apt/lists/*
|
|||
|
|
更新软件包列表
|
|||
|
|
安装 Maven 构建工具
|
|||
|
|
清理缓存减小镜像体积
|
|||
|
|
编译 Java 项目
|
|||
|
|
COPY . /build # 复制整个项目到 /build
|
|||
|
|
WORKDIR /build # 切换工作目录
|
|||
|
|
RUN ls && mvn clean package -Dmaven.test.skip=true # Maven 打包，跳过测试
|
|||
|
|
WORKDIR /build/target # 进入 target 目录
|
|||
|
|
RUN mv wvp-pro-*.jar wvp.jar # 重命名 jar 包
|
|||
|
|
关键点：
|
|||
|
|
COPY . /build 会复制 docker-compose.yml 中 context: .. 指定的整个项目根目录
|
|||
|
|
-Dmaven.test.skip=true 跳过单元测试，加快构建速度
|
|||
|
|
将生成的 wvp-pro-*.jar 统一重命名为 wvp.jar
|
|||
|
|
|
|||
|
|
|
|||
|
|
第二阶段：Runtime（运行阶段）
|
|||
|
|
基础镜像
|
|||
|
|
FROM ringcentral/jdk:11
|
|||
|
|
重新使用干净的 JDK 11 镜像
|
|||
|
|
不包含 Maven 等构建工具，镜像更小
|
|||
|
|
准备运行环境
|
|||
|
|
RUN mkdir -p /opt/wvp # 创建应用目录
|
|||
|
|
WORKDIR /opt/wvp # 设置工作目录
|
|||
|
|
COPY --from=builder /build/target /opt/wvp # 从 builder 阶段复制编译产物
|
|||
|
|
COPY ./docker/wvp/wvp /opt/wvp # 复制配置文件
|
|||
|
|
关键点：
|
|||
|
|
--from=builder 从第一阶段复制文件，实现多阶段构建
|
|||
|
|
复制 ./docker/wvp/wvp 目录（包含配置文件）
|
|||
|
|
启动命令
|
|||
|
|
ENTRYPOINT ["java", "-Xms512m", # 初始堆内存 512MB
|
|||
|
|
"-Xmx1024m", # 最大堆内存 1GB
|
|||
|
|
"-XX:+HeapDumpOnOutOfMemoryError", # OOM 时生成堆转储
|
|||
|
|
"-XX:HeapDumpPath=/opt/ylcx/", # 堆转储文件路径
|
|||
|
|
"-jar", "wvp.jar", # 运行 jar 包
|
|||
|
|
"--spring.config.location=/opt/ylcx/wvp/application.yml" # 指定配置文件
|
|||
|
|
]
|
|||
|
|
JVM 参数说明：
|
|||
|
|
-Xms512m / -Xmx1024m：适合中小型部署
|
|||
|
|
HeapDumpOnOutOfMemoryError：便于排查内存问题
|
|||
|
|
Spring Boot 配置文件路径：/opt/ylcx/wvp/application.yml
|
|||
|
|
构建上下文
|
|||
|
|
在 docker-compose.yml:84-86 中：
|
|||
|
|
build:
|
|||
|
|
context: .. # 项目根目录
|
|||
|
|
dockerfile: ./docker/wvp/Dockerfile # Dockerfile 路径
|
|||
|
|
目录结构：
|
|||
|
|
stream-deploy/ ← context 根目录
|
|||
|
|
├── src/ ← Java 源码
|
|||
|
|
├── pom.xml ← Maven 配置
|
|||
|
|
├── docker/
|
|||
|
|
│ ├── docker-compose.yml
|
|||
|
|
│ └── wvp/
|
|||
|
|
│ ├── Dockerfile ← 当前文件
|
|||
|
|
│ └── wvp/ ← 配置文件目录
|
|||
|
|
│ └── application.yml
|
|||
|
|
└── ...
|
|||
|
|
多阶段构建的优势
|
|||
|
|
镜像体积小：最终镜像不包含 Maven、源码等构建工具
|
|||
|
|
安全性高：运行环境不包含编译工具链
|
|||
|
|
构建效率：利用 Docker 缓存层加速重复构建
|
|||
|
|
配置文件挂载
|
|||
|
|
在 docker-compose.yml 中：
|
|||
|
|
volumes:
|
|||
|
|
- ./wvp/wvp/:/opt/ylcx/wvp/ # 挂载配置文件
|
|||
|
|
- ./logs/wvp:/opt/wvp/logs/ # 挂载日志目录
|
|||
|
|
实际配置文件路径：./docker/wvp/wvp/application.yml
|
|||
|
|
注释掉的旧方案
|
|||
|
|
第 71-84 行的注释代码是旧的构建方案：
|
|||
|
|
从 Gitee 克隆 WVP-GB28181-pro 源码
|
|||
|
|
在容器内编译
|
|||
|
|
现在改为在宿主机或 builder 阶段编译，更高效
|