Jenkins并行阶段变量被覆盖，如何实现变量本地作用域？

问题根源 #

Jenkins Pipeline的Groovy脚本默认采用闭包延迟绑定，当在循环中定义并行任务时，如果变量是在循环外部或共享作用域声明的，所有并行分支会共享同一个变量引用，导致后续分支覆盖前面分支的变量值。而NODE_USERNAME是代理节点的内置环境变量，属于节点本地作用域，不会被共享，所以结果正确。

实现变量完全本地生效的方法 #

1. 用闭包捕获当前变量值（强制立即绑定） #

在循环内部通过闭包捕获当前迭代的变量副本，避免延迟绑定导致的变量引用共享。示例代码：

def architectures = ['amd64', 'arm64', 'ppc64le']
def parallelStages = [:]

architectures.each { arch ->
    parallelStages["test_${arch}"] = {
        node("${arch}-agent") {
            // 变量在节点上下文内定义，每个分支拥有独立副本
            def ANSIBLE_CREDENTIALS = "cred-${arch}"
            def HOSTS_FILE = "hosts-${arch}.ini"
            def SOME_VARIABLE = "value-${arch}"
            
            stage("Test ${arch}") {
                echo "NODE_USERNAME: ${NODE_USERNAME}"
                echo "ANSIBLE_CREDENTIALS: ${ANSIBLE_CREDENTIALS}"
                echo "HOSTS_FILE: ${HOSTS_FILE}"
                echo "SOME_VARIABLE: ${SOME_VARIABLE}"
                // 执行测试逻辑
            }
        }
    }
}

parallel parallelStages

2. 将变量限定在代理节点的node块内部 #

所有自定义变量都在node块（代理节点的执行上下文）中声明，确保变量被严格限定在当前节点的本地作用域，不会被其他并行代理访问或覆盖。

3. 使用withEnv设置节点本地环境变量 #

如果需要用环境变量而非Groovy变量，可通过withEnv在节点内部定义，确保环境变量仅对当前节点的任务生效：

architectures.each { arch ->
    parallelStages["test_${arch}"] = {
        node("${arch}-agent") {
            withEnv([
                "ANSIBLE_CREDENTIALS=cred-${arch}",
                "HOSTS_FILE=hosts-${arch}.ini",
                "SOME_VARIABLE=value-${arch}"
            ]) {
                stage("Test ${arch}") {
                    echo "NODE_USERNAME: ${NODE_USERNAME}"
                    echo "ANSIBLE_CREDENTIALS: ${env.ANSIBLE_CREDENTIALS}"
                    echo "HOSTS_FILE: ${env.HOSTS_FILE}"
                    echo "SOME_VARIABLE: ${env.SOME_VARIABLE}"
                }
            }
        }
    }
}

4. 禁止在循环外部声明共享变量 #

不要在循环外部定义会被各并行分支修改的变量，所有随迭代变化的变量都应在循环内部的闭包或节点块中声明，确保每个分支拥有独立的变量副本。

关键注意事项 #

• 永远不要在并行任务的共享作用域中定义可变状态的变量，Groovy的闭包延迟绑定会导致变量引用被共享。
• 代理节点的内置环境变量（如NODE_USERNAME、WORKSPACE）本身就是节点本地的，不会出现覆盖问题，自定义变量需要手动隔离作用域。

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