在现代 DevOps 实践中，将 Java 应用容器化是提升部署效率和环境一致性的关键步骤。本文将结合实际案例，详细介绍如何通过Dockerfile和自动化脚本实现 Java 项目的构建、打包、镜像生成及仓库推送的全流程自动化。

容器化架构设计：多阶段构建的优势

我们采用 Docker 多阶段构建策略，将构建过程与运行环境分离，大幅减小最终镜像体积。完整的Dockerfile分为两个主要阶段：

构建阶段：编译打包

# ---------- 构建阶段 ----------
FROM maven:3.9-eclipse-temurin-8 AS builder

WORKDIR /src

# 配置Maven镜像源（加速依赖下载）
COPY settings-docker.xml /usr/share/maven/conf/settings.xml

# 复制依赖描述文件
COPY pom.xml .

# 预下载依赖（利用Docker缓存机制）
RUN mvn -B -e dependency:go-offline

# 复制源码并打包
COPY src ./src
RUN mvn -B -e clean package -DskipTests

这一阶段使用包含 Maven 和 JDK 的完整构建环境，重点优化了依赖下载环节：通过先复制pom.xml并执行dependency:go-offline，可以充分利用 Docker 的层缓存机制，避免每次代码变更都重新下载所有依赖。

运行阶段：精简部署

# ---------- 运行阶段 ----------
FROM openjdk:8-jre-alpine

# 配置系统时区
ENV TZ=Asia/Shanghai
RUN apk add --no-cache tzdata && \
    ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && \
    echo $TZ > /etc/timezone

# 创建应用目录结构
RUN mkdir -p /app /config /app-log
WORKDIR /app

# 从构建阶段拷贝打包好的jar文件
COPY --from=builder /src/target/*.jar app.jar

# 暴露应用端口
EXPOSE 8080

# 启动命令配置
ENTRYPOINT ["java", \
            "-Duser.timezone=GMT+08", \
            "-Dspring.config.location=/config/application-prod.yml", \
            "-Dspring.profiles.active=prod", \
            "-jar", \
            "app.jar"]

运行阶段采用轻量级的 Alpine 镜像（仅包含 JRE），相比完整 JDK 镜像体积减少约 70%。同时通过环境变量和软链接确保时区正确性，创建了规范的目录结构用于应用运行、配置文件挂载和日志存储。

自动化构建脚本：从信息提取到镜像推送

为了简化构建流程，我们编写了build_docker.sh脚本实现全流程自动化，核心功能包括：

1. 前置检查与环境验证

# 检查pom.xml文件是否存在
if [ ! -f "pom.xml" ]; then
    echo "错误：当前目录未找到pom.xml文件，请在项目根目录执行此脚本"
    exit 1
fi

# 检查xmllint工具是否安装
if ! command -v xmllint &> /dev/null; then
    echo "错误：未检测到xmllint工具，请先安装"
    exit 1
fi

脚本首先验证运行环境，确保必要的文件和工具存在，避免后续步骤因依赖缺失而失败。

2. 从 Maven 配置提取项目信息

# 从pom.xml提取项目名称（处理命名空间）
APP_NAME=$(xmllint --xpath "//*[local-name()='project']/*[local-name()='name']/text()" pom.xml 2>/dev/null | tr -d '[:space:]')

# 从pom.xml提取项目版本
APP_VERSION=$(xmllint --xpath "//*[local-name()='project']/*[local-name()='version']/text()" pom.xml 2>/dev/null | tr -d '[:space:]')

# 清理应用名称中的非法字符（仅保留Docker允许的字符）
APP_NAME=$(echo "$APP_NAME" | sed 's/[^a-zA-Z0-9_-]//g')

通过xmllint工具从pom.xml中提取项目名称和版本号，并对名称进行标准化处理，确保符合 Docker 镜像命名规范。

3. 镜像构建与标签管理

# 定义镜像名称
LOCAL_IMAGE_FULL="${APP_NAME}:${APP_VERSION}"
LOCAL_IMAGE_LATEST="${APP_NAME}:latest"

# 构建镜像
echo "开始构建镜像..."
docker build -t "$LOCAL_IMAGE_FULL" . || {
    echo "错误：镜像构建失败"
    exit 1
}

# 打latest标签
docker tag "$LOCAL_IMAGE_FULL" "$LOCAL_IMAGE_LATEST" || {
    echo "错误：镜像打latest标签失败"
    exit 1
}

脚本采用 “版本号 + latest” 的双标签策略，既保留了精确的版本历史，又提供了便捷的最新版本引用。

4. 镜像推送与仓库管理

# 询问是否上传镜像
read -p "是否将镜像上传到仓库 '$REMOTE_REGISTRY'? (y/n) " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
    # 登录私有仓库
    REGISTRY_DOMAIN=$(dirname "$REMOTE_REGISTRY")
    # 推送带版本的镜像和latest标签镜像
    # ...
fi

脚本支持将构建好的镜像推送到私有仓库，并处理了仓库登录验证流程，既保证了安全性，又简化了操作步骤。

最佳实践总结

1. 多阶段构建：分离构建环境和运行环境，减小镜像体积，提高安全性

2. 缓存优化：合理安排文件复制顺序，最大化利用 Docker 缓存

3. 配置外部化：通过环境变量和挂载卷实现配置与应用分离

4. 标准化命名：基于项目元数据自动生成镜像标签，保持版本一致性

5. 自动化流程：通过脚本封装复杂操作，减少人为失误，提高效率

通过这套容器化方案，开发团队可以轻松实现 “一次构建，到处运行” 的目标，显著提升 Java 应用的部署效率和环境一致性。