如何在Jenkins流水线中无重复步骤地在多容器执行相同操作？

错误原因 #

你碰到的java.lang.NoSuchMethodError: No such DSL method 'agent' found among steps错误，核心原因是：声明式流水线的agent指令仅能在pipeline根节点或顶级stage节点下使用，不能嵌套在script块的脚本式闭包中。agent是声明式语法的专属指令，无法在脚本式代码逻辑里调用。

可行解决方案 #

方案1：声明式流水线动态生成并行Stage #

通过脚本块生成并行分支，既保留声明式结构，又避免重复代码：

pipeline {
  agent none
  stages {
    stage('Parallel Python Runs') {
      steps {
        script {
          def containers = ['python:3.10', 'python:3.11', 'python:3.12']
          def parallelStages = [:]
          
          containers.each { container ->
            parallelStages["Run on ${container}"] = {
              stage("Run on ${container}") {
                agent { docker container }
                steps {
                  sh 'src/main.py'
                }
              }
            }
          }
          
          parallel parallelStages
        }
      }
    }
  }
}

方案2：脚本式语法结合Docker容器执行 #

如果需要更简洁的实现，可直接使用docker.image().inside()方法在容器内运行步骤，无需声明式agent：

pipeline {
  agent none
  stages {
    stage('Parallel Execution') {
      steps {
        script {
          def containers = ['python:3.10', 'python:3.11', 'python:3.12']
          def parallelTasks = [:]
          
          containers.each { container ->
            parallelTasks[container] = {
              echo "Executing in ${container}"
              docker.image(container).inside {
                sh 'src/main.py'
              }
            }
          }
          
          parallel parallelTasks
        }
      }
    }
  }
}

方案对比 #

• 方案1的每个并行分支都是独立的Stage，在Jenkins控制台会清晰展示每个容器的运行状态，便于排查问题。
• 方案2代码更紧凑，适合对UI展示要求不高、追求简洁的场景。

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