Jenkins声明式流水线：如何为动态并行阶段设置Agent标签

你的代码里有两个关键问题导致指定的Agent未生效，同时存在变量错误：

问题1：变量作用域引用错误 #

Groovy闭包捕获的是变量引用而非值，循环中直接使用stageName会导致所有并行阶段最终使用循环最后一次迭代的stageName值。另外代码里的stagesMap[testName]是笔误，testName未定义，应该用stageName作为Map的键。

问题2：Agent配置未被正确解析 #

Jenkins Pipeline处理动态并行阶段时，需要确保Agent配置是Stage的直接声明，同时要避免闭包序列化导致的配置丢失。

修正后的代码 #

def stagesMap = [:]
for (int i = 1; i < 3; i++) {
    // 捕获当前迭代的变量值，避免闭包共享同一引用
    def currentStageName = "Stage ${i}"
    stagesMap[currentStageName] = {
        stage(currentStageName) {
            agent { label 'SomeAgent' }
            script {
                someFunctionCall()
            }
        }
    }
}
parallel stagesMap

额外检查项 #

• 确认SomeAgent是Jenkins中存在的有效节点标签，且该节点处于在线可用状态
• 如果流水线顶层设置了全局agent（比如agent any），可以在流水线开头添加agent none，强制每个Stage自行指定运行节点

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