Jenkins参数化任务中如何获取密码参数的明文值？

自由风格项目解决方案 #

• 通过系统Groovy脚本做预处理，在构建启动前获取密码明文并生成可直接使用的参数：

  1. 给任务添加「Execute system Groovy script」构建步骤
  2. 填入以下脚本（替换对应参数名）：

     import hudson.model.*
     
     def build = Thread.currentThread().executable
     // 替换成你的密码参数名
     def passParam = build.getAction(ParametersAction.class).getParameter("pass")
     def plainPass = passParam.getPlainText()
     // 替换成你要传递的目标参数名
     def targetParam = new StringParameterValue("api_token", plainPass)
     build.addAction(new ParametersAction(targetParam))
     

  3. 后续构建步骤里就能直接用${api_token}访问明文密码

• 注意：如果遇到脚本权限报错，需要在Jenkins「脚本安全」页面（Manage Jenkins -> In-process Script Approval）批准相关方法调用。

Pipeline项目解决方案 #

直接在Pipeline的预处理阶段获取明文并赋值：

pipeline {
    agent any
    parameters {
        password(name: 'pass', description: '原始密码参数')
        string(name: 'api_token', defaultValue: '', description: '用于API的明文参数')
    }
    stages {
        stage('处理密码参数') {
            steps {
                script {
                    // 拿到密码明文并赋值给目标参数/环境变量
                    env.api_token = params.pass.getPlainText()
                }
            }
        }
        stage('调用API') {
            steps {
                sh 'curl -H "Authorization: Token ${api_token}" https://your-api-endpoint'
            }
        }
    }
}

为什么之前的方法无效？ #

• 自由风格项目里，在参数定义环节直接引用密码参数时，Jenkins会自动加密屏蔽明文；普通上下文调用getPlainText()会因为权限不足或构建未初始化失败。
• 只有进入构建执行阶段（Groovy脚本、Pipeline的script块），构建对象完全初始化后，才能正常调用getPlainText()获取明文。

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