Jenkins 3.346.2：Kubernetes代理上声明式Pipeline动态并行阶段阻塞问题

问题原因 #

1. 节点调度时机错误：在projects.each循环中直接执行node { ... }代码块，会立即触发节点调度请求，而非将任务逻辑作为闭包存入projectStages等待parallel执行。此时主Pipeline已占用master节点，未指定标签的node块默认请求的节点资源无法满足（或误请求被保留的master节点），导致任务陷入调度阻塞。
2. 语法混用冲突：声明式Pipeline的agent语法不能直接嵌套在脚本式node块中，这种跨范式的语法混用会导致Jenkins执行逻辑混乱，进一步加剧调度异常。

解决办法 #

核心思路是将每个并行任务的逻辑包装为闭包，延迟节点调度时机到parallel执行阶段，同时使用脚本式语法适配动态并行场景，避免声明式与脚本式语法冲突。

修复后的代码示例 #

pipeline {
  agent { label 'master' }
  stages {
    stage('Test') {
      steps {
        script {
          def projects = [
            [ name: 'project1', dir: 'path/1' ],
            [ name: 'project2', dir: 'path/2' ],
            [ name: 'project3', dir: 'path/3' ]
          ]
          
          def projectStages = [:]

          projects.each { project ->
            // 捕获循环变量到局部变量，避免闭包延迟绑定问题
            def projectName = project.name
            // 将任务逻辑包装为闭包，仅在parallel执行时触发调度
            projectStages[projectName] = {
              podTemplate(yaml: libraryResource('my-agent.yaml')) {
                node(POD_LABEL) {
                  container('my-build-container') {
                    echo "Running: $projectName"
                    sh('hostname')
                  }
                }
              }
            }
          }
          
          parallel projectStages
        }
      }
    }
  }
}

关键修复点说明 #

• 闭包包装任务逻辑：用{ ... }将每个项目的执行逻辑包裹为闭包，存入projectStages映射，确保只有在parallel指令执行时才会触发对应的Kubernetes Pod调度。
• 使用脚本式podTemplate：替代声明式agent kubernetes，适配脚本式闭包的执行环境，避免语法混用冲突。podTemplate会自动生成带有唯一标签的Pod，node(POD_LABEL)用于绑定到该Pod。
• 捕获循环变量：将project.name赋值给局部变量projectName，解决闭包延迟绑定导致所有并行任务引用最后一个项目变量的问题。

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