1. 脚本化流水线中获取构建参数的方法 #

在Jenkins脚本化流水线里，获取构建参数其实很直接，主要有几种常用方式：

• 直接引用参数名：如果已经定义了构建参数（比如名为DEPLOY_ENV的字符串参数），可以直接在脚本里调用：

  echo "当前部署环境: ${DEPLOY_ENV}"
  

• 通过params对象访问：如果参数名和现有变量冲突，或者想更清晰标识这是构建参数，用params对象更稳妥：

  echo "当前部署环境: ${params.DEPLOY_ENV}"
  

• 批量遍历所有参数：如果需要处理所有构建参数，可以遍历params的键值对：

  params.each { key, value ->
      echo "参数${key}的值是: ${value}"
  }
  

另外布尔类型的参数不用额外转换，直接用if (params.IS_TEST)这类判断即可。

2. 获取带指定标签节点上运行中构建的参数 #

你已经能拿到Executor对象，接下来核心是从Executor追到对应的运行中构建（Run对象），再从中提取参数。我帮你补全并优化了代码，每一步逻辑都写在注释里：

import jenkins.model.Jenkins
import hudson.model.Run
import hudson.model.ParametersAction

def getRemoteBuildParameters(String targetLabel) {
    // 获取Jenkins实例（注意：如果在流水线中运行，可能需要在脚本安全中批准相关方法）
    def jenkins = Jenkins.get()
    
    // 筛选出带有目标标签的所有节点
    def targetNodes = jenkins.nodes.findAll { node ->
        // 拆分节点标签为列表，判断是否包含目标标签
        node.labelString.split().contains(targetLabel)
    }
    
    targetNodes.each { node ->
        println "=== 节点名称: ${node.name} ==="
        // 遍历节点的所有Executor
        node.executors.each { executor ->
            // 只处理正在运行任务的Executor
            if (executor.busy) {
                // 从Executor获取当前运行的构建实例（Run对象）
                Run currentBuild = executor.currentExecutable
                if (currentBuild) {
                    println "正在运行的构建: #${currentBuild.number} - ${currentBuild.displayName}"
                    // 获取构建的参数动作，这是存储参数的关键对象
                    ParametersAction paramsAction = currentBuild.getAction(ParametersAction.class)
                    if (paramsAction) {
                        println "构建参数详情:"
                        paramsAction.parameters.each { param ->
                            println "- ${param.name}: ${param.value}"
                        }
                    } else {
                        println "该构建未设置任何参数"
                    }
                }
            }
        }
        println "" // 空行分隔不同节点的输出
    }
}

// 调用方法，替换成你要匹配的标签
getRemoteBuildParameters("your-target-label")

关键步骤说明： #

1. 从Executor到Run对象：通过executor.currentExecutable可以拿到当前正在运行的构建实例，这是连接Executor和构建参数的核心桥梁。
2. 提取参数：构建的参数都存在ParametersAction对象里，通过currentBuild.getAction(ParametersAction.class)获取后，遍历parameters集合就能拿到每个参数的名称和值。
3. 权限注意：如果是在Jenkins流水线中运行这段脚本，可能需要在「Manage Jenkins」→「In-process Script Approval」里批准相关的方法调用（比如Jenkins.get()、node.executors等），否则会触发权限报错。

内容的提问来源于stack exchange，提问作者Corey Olson