velo/toolchains-4-ci-builds

镜像概述

本Docker镜像整合了多个JDK版本和预配置的Maven工具链，旨在为Java项目的持续集成（CI）流程提供统一、高效的构建环境。通过预先打包主流JDK版本和Maven工具链，避免了CI环境中重复配置Java开发环境的繁琐步骤，支持快速切换不同Java版本进行构建和测试，提升CI流程的稳定性和效率。

核心功能与特性

多JDK版本支持

• 集成主流JDK版本（如JDK 8、11、17等），满足不同Java项目的版本需求
• 各JDK版本独立安装，路径规范（如/usr/lib/jvm/java-8-openjdk、/usr/lib/jvm/java-11-openjdk等），便于切换

预配置Maven工具链

• 内置Maven（3.6+版本），并预配置toolchains.xml，自动识别并关联镜像中的多JDK版本
• 支持通过Maven命令直接指定目标JDK版本，无需手动配置工具链

CI环境优化

• 基于轻量级基础镜像（如Alpine或Debian Slim），减少镜像体积，加快CI流程启动速度
• 内置常用构建依赖（如Git、curl等），满足基础代码拉取和网络请求需求
• 非root用户运行设计，符合容器安全最佳实践

使用场景

Java项目持续集成构建

适用于Jenkins、GitLab CI、GitHub Actions等CI平台，作为Java项目构建步骤的执行环境，直接运行mvn clean package等命令。

多JDK版本兼容性测试

在同一CI流程中快速切换JDK 8、11、17等版本，验证项目在不同Java环境下的编译和运行兼容性。

自动化测试流程

配合测试框架（如JUnit、TestNG），在多JDK环境下执行单元测试、集成测试，确保测试覆盖全面。

开发环境一致性保障

本地开发可通过该镜像模拟CI环境，避免"本地能跑，CI失败"的环境差异问题。

使用方法与配置说明

基本使用

检查镜像信息

bash
docker run --rm your-image-name java -version  # 查看默认JDK版本
docker run --rm your-image-name mvn -version   # 查看Maven版本及关联JDK

运行Maven构建（默认JDK）

bash
# 挂载项目目录并执行Maven构建
docker run --rm -v $(pwd):/app -w /app your-image-name mvn clean package

指定JDK版本

通过环境变量切换JDK

bash
# 使用JDK 11执行构建
docker run --rm -e JAVA_VERSION=11 -v $(pwd):/app -w /app your-image-name mvn clean package

# 使用JDK 17执行测试
docker run --rm -e JAVA_VERSION=17 -v $(pwd):/app -w /app your-image-name mvn test

通过Maven工具链指定版本

在项目pom.xml中配置工具链插件，镜像会自动识别并使用对应JDK：

xml
<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-toolchains-plugin</artifactId>
      <version>3.1.0</version>
      <configuration>
        <toolchains>
          <jdk>
            <version>11</version>  <!-- 匹配镜像中的JDK 11 -->
          </jdk>
        </toolchains>
      </configuration>
    </plugin>
  </plugins>
</build>

运行命令：

bash
docker run --rm -v $(pwd):/app -w /app your-image-name mvn clean package -toolchains

Docker Compose配置示例

yaml
version: '3'
services:
  java-ci:
    image: your-image-name
    environment:
      - JAVA_VERSION=11  # 指定JDK 11
      - MAVEN_OPTS=-Xmx512m  # 配置Maven内存参数
    volumes:
      - ./:/app
    working_dir: /app
    command: mvn clean package

配置参数说明

注意事项

• 镜像中JDK版本需根据实际需求确认（可通过docker run --rm your-image-name ls /usr/lib/jvm查看所有版本）
• 挂载本地Maven仓库（如-v ~/.m2:/root/.m2）可加速依赖下载，但需注意权限问题
• 对于大型项目，建议通过MAVEN_OPTS调整内存参数，避免OOM错误