如何在Jenkins Docker代理中动态设置JAVA_HOME

架构老林

2026-8-4

实现Docker代理中动态设置JAVA_HOME的方案

完全可以实现，不用每次在命令行声明env JAVA_HOME，以下是几种可行的方法：

1. 在Docker代理启动时注入环境变量

直接在Jenkins的Docker代理配置中，结合JTE的config变量动态设置JAVA_HOME，容器启动后该变量会全局生效：

agent {
  docker {
    image '你的多JDK镜像名称'
    environment [
      JAVA_HOME: "/opt/jdk-${config.jdk_version}"
    ]
  }
}

配置完成后，后续所有sh步骤都能读取到正确的JAVA_HOME，Maven命令可以简化为：

sh('/opt/maven-3/bin/mvn compile')

2. 在流水线中全局定义环境变量

如果不想在代理层面配置，可通过Jenkins流水线的environment块全局设置JAVA_HOME，所有阶段的步骤都会继承这个变量：

pipeline {
  agent { docker '你的多JDK镜像名称' }
  environment {
    JAVA_HOME = "/opt/jdk-${config.jdk_version}"
  }
  stages {
    stage('验证环境') {
      steps {
        sh 'echo $JAVA_HOME' // 输出对应版本的JDK路径，比如/opt/jdk-11
      }
    }
    stage('构建项目') {
      steps {
        sh '/opt/maven-3/bin/mvn compile'
      }
    }
  }
}

3. 基于JTE模板库封装JDK配置

利用JTE插件的模板库能力，把JDK环境配置封装成可复用的步骤，统一管理：

模板库中定义配置脚本（比如jdk_setup.groovy）：

void configure() {
  env.JAVA_HOME = "/opt/jdk-${config.jdk_version}"
}

在流水线模板中调用该步骤：

pipeline {
  agent { docker '你的多JDK镜像名称' }
  stages {
    stage('初始化环境') {
      steps {
        jdk_setup.configure()
      }
    }
    stage('构建') {
      steps {
        sh 'echo $JAVA_HOME'
        sh '/opt/maven-3/bin/mvn compile'
      }
    }
  }
}