声明式流水线中如何在Active Choice参数脚本块无插值访问全局变量

问题场景 #

我在Jenkinsfile中编写了如下代码：

def testList = ['a','b','c']

properties([[
        [$class: 'CascadeChoiceParameter',
        choiceType: 'PT_SINGLE_SELECT',
        description: 'Some description',
        filterLength: 1, 
        filterable: true, 
        name: 'TestParameter',
        randomName: 'choice-parameter-47114921421532360', 
        script: [
            $class: 'GroovyScript', 
            fallbackScript: [
                classpath: [], 
                sandbox: false, 
                script: 'return [\'ERROR\']'
            ],
            script: [
                classpath: [], 
                sandbox: false, 
                script: 'return testList'
            ]
        ]]
]])

需要在不使用字符串插值的前提下，让脚本块获取testList的值，同时满足以下限制：

• 生产环境中testList为动态生成，字符串插值会导致每次修改都需通过Jenkins脚本审批，流程繁琐
• 不额外暴露参数给用户
• 暂不创建共享库

我尝试过以下方法，但均无效或存在副作用：

• 使用inspect进行字符串插值（"return ${testList.inspect()}"）
• 给testList添加@field注解
• 添加ArrayList参数，触发“ArrayList类型不被识别为参数类型”异常

解决方案 #

通过Groovy脚本的binding对象传递变量，脚本字符串保持固定，无需随testList变动修改，具体代码修改如下：

def testList = ['a','b','c']
// 将testList存入当前脚本的binding上下文
binding.setVariable('testList', testList)

properties([[
        [$class: 'CascadeChoiceParameter',
        choiceType: 'PT_SINGLE_SELECT',
        description: 'Some description',
        filterLength: 1, 
        filterable: true, 
        name: 'TestParameter',
        randomName: 'choice-parameter-47114921421532360', 
        script: [
            $class: 'GroovyScript', 
            fallbackScript: [
                classpath: [], 
                sandbox: false, 
                script: 'return [\'ERROR\']'
            ],
            script: [
                classpath: [], 
                sandbox: false, 
                // 固定脚本字符串，从binding中获取变量
                script: 'return binding.variables.testList'
            ]
        ]]
]])

核心原理 #

1. binding.setVariable将testList注入当前Jenkinsfile的脚本绑定上下文，GroovyScript执行时会继承该上下文
2. 脚本字符串为固定内容，不会随testList的动态生成内容变化，避免了频繁的脚本审批
3. 无需额外暴露参数或创建共享库，完全符合需求限制

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