Jenkins脚本式流水线动态并行阶段如何运行在独立Docker容器

配置不生效的核心原因是：声明式流水线的agent { docker {} }语法块仅支持在声明式流水线的固定stage层级直接声明使用。你在script{}块中通过闭包动态生成的stage属于脚本式流水线语法范畴，直接嵌套声明式的agent配置块无法被Jenkins解析识别。

不需要调整现有动态生成阶段、并行执行的逻辑，只需要移除父阶段统一配置的Docker agent，在动态生成的阶段内部，使用脚本式流水线原生的Docker调用语法包裹业务逻辑即可。每个并行阶段会独立拉起对应Docker容器，执行完成后自动销毁，容器之间完全隔离，互不干扰。
如果需要给不同阶段指定不同的运行镜像，只需要调整从文件读取的列表结构，把每个阶段对应的镜像地址作为参数传入generateStage函数即可。

修正后代码示例 #

// 支持扩展入参：阶段名、对应镜像、执行参数等
def generateStage(stageName, stageImage = 'default-runtime:latest') {
    return {
        stage("stage: ${stageName}") {
            // 脚本式语法：拉起独立的指定镜像容器执行内部逻辑
            docker.image(stageImage).inside {
                // 写入该阶段的具体业务逻辑
                sh "echo 当前运行在独立容器中，执行阶段：${stageName}"
                // do something
            }
        }
    }
} 

pipeline{
  agent none
  stages{
    // 其他前置阶段保持原有逻辑不变
    stage('parallel stages') {
      // 父阶段仅分配通用Jenkins节点，不绑定固定Docker容器
      agent any
      steps {
          script {
            // 动态列表可自定义每个阶段的镜像，示例多镜像结构：[[name:"STAGE-A", img:"runtime-a:v1"], [name:"STAGE-B", img:"runtime-b:v2"]]
            def list = ["STAGE-A", "STAGE-B"] // 替换为从文件读取生成的动态列表
            def parallelStages = list.collectEntries{ stageItem ->
                // 单镜像场景：所有阶段用同一个默认镜像
                ["$stageItem": generateStage(stageItem)]
                // 多镜像场景替换为下行代码
                // ["${stageItem.name}": generateStage(stageItem.name, stageItem.img)]
            }
            parallel parallelStages
          }
      }
    }
  }
}

注意事项 #

• 确保运行流水线的Jenkins agent节点已安装Docker运行环境，且Jenkins执行用户拥有Docker操作权限
• 如果容器运行需要挂载目录、传入环境变量、配置Docker运行参数，可以直接在inside()方法中传入，例如docker.image(stageImage).inside('-v /host/path:/container/path -e RUN_ENV=prod') { // 业务逻辑 }
• 该实现完全保留动态阶段生成、多阶段并行执行的特性，每个阶段的容器独立分配资源，不会出现环境冲突。

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