全栈攻城狮

Appearance

Jenkins 配置 JDK ​

在 Jenkins 容器中安装并配置 JDK 编译环境

下载 JDK ​

推荐使用 Eclipse Temurin（原 AdoptOpenJDK）或 Oracle JDK：

安装步骤 ​

1. 进入容器创建目录 ​

bash
docker exec -it jenkins bash
mkdir -p /home/soft
exit

2. 在宿主机准备安装包 ​

bash
mkdir -p /home/soft/pkg

3. 拷贝安装包到容器 ​

bash
# 将下载好的 JDK 压缩包拷贝到容器内
docker cp /home/soft/pkg/jdk-17.0.10_linux-x64.tar.gz jenkins:/home/soft/

4. 容器内解压 ​

bash
docker exec -it jenkins bash
cd /home/soft
tar -xzvf jdk-17.0.10_linux-x64.tar.gz
# 确认解压后的路径
ls /home/soft/jdk-17.0.10
exit

5. Jenkins 全局工具配置 ​

  1. 进入 Jenkins：系统管理 → 全局工具配置
  2. 找到 JDK 区域，点击 新增 JDK
  3. 填写：
    • 名称：自定义，如 JDK17（后续在 Pipeline 中引用）
    • JAVA_HOME：解压后的完整路径，如 /home/soft/jdk-17.0.10
    • 取消勾选 自动安装
  4. 点击 保存

6. 验证配置 ​

创建一个测试 Pipeline 任务，添加以下步骤验证 JDK：

groovy
pipeline {
    agent any
    tools {
        jdk 'JDK17'  // 对应全局工具配置中的名称
    }
    stages {
        stage('Check JDK') {
            steps {
                sh 'java -version'
                sh 'javac -version'
            }
        }
    }
}

运行后控制台输出应显示 openjdk version "17.0.10" 等 JDK 版本信息。

多 JDK 版本配置 ​

Jenkins 支持配置多个 JDK 版本，不同项目可按需选择：

  1. 在 全局工具配置 中新增多个 JDK 实例：
名称JAVA_HOME
JDK8/home/soft/jdk1.8.0_351
JDK11/home/soft/jdk-11.0.22
JDK17/home/soft/jdk-17.0.10
JDK21/home/soft/jdk-21.0.2
  1. 在 Pipeline 中通过 tools 指定：
groovy
pipeline {
    agent any
    tools {
        jdk 'JDK17'
    }
    stages {
        stage('Build with JDK 17') {
            steps {
                sh 'java -version'
                sh 'mvn clean package'
            }
        }
    }
}

注意事项 ​

  • 容器重启后路径不变：使用 Docker volume 挂载的 jenkins_home，JDK 安装文件会保留。但如果容器被销毁重建，/home/soft 下的文件会丢失，需要重新拷贝
  • 推荐做法：将 JDK 安装包放入 Docker volume 中，或使用自定义 Docker 镜像预装 JDK
  • 自动安装替代：Jenkins 支持从 adoptium.net 自动下载 JDK，但国内网络可能较慢，建议手动安装

参考链接 ​