如何基于单个Jenkinsfile并行运行多Docker容器的Jenkins流水线

兄弟，我太懂你折腾一整天的崩溃了——想把Jenkins流水线拆成多Docker容器并行，结果阶段全揉成一团，Blue Ocean里的概览完全不直观，这坑我之前也踩过！

核心问题在于：如果你用全局agent或者把所有阶段塞进同一个agent块里，Jenkins会默认把它们绑定到同一个容器，就算用了parallel也会导致阶段合并展示。要解决这个，得让每个并行分支独立指定agent，同时把同容器内的阶段嵌套成子stage。

直接可用的Jenkinsfile示例 #

pipeline {
  agent none  // 关键：全局不指定默认agent，让每个分支自己选容器
  stages {
    stage('Parallel Pipeline') {
      parallel {
        // 第一个容器：执行Prepare + Build（共享环境，所以放同分支）
        stage('Build Workflow') {
          agent { docker { image 'python:3.11-slim' } }
          stages {
            stage('Prepare Dependencies') {
              steps {
                sh 'echo "Installing dependencies..."'
                sh 'pip install --upgrade pip && pip install -r requirements.txt'
              }
            }
            stage('Build Application') {
              steps {
                sh 'echo "Building package..."'
                sh 'python setup.py sdist bdist_wheel'
              }
              post {
                success {
                  // 如果后续阶段需要产物，用stash暂存
                  stash includes: 'dist/**', name: 'build-artifacts'
                }
              }
            }
          }
        }

        // 第二个容器：独立执行Test
        stage('Run Tests') {
          agent { docker { image 'python:3.11-slim' } }
          steps {
            unstash 'build-artifacts'  // 取出Build阶段的产物
            sh 'echo "Running unit tests..."'
            sh 'pytest tests/ --cov=myapp'
          }
        }

        // 第三个容器：独立执行Docs生成
        stage('Generate Documentation') {
          agent { docker { image 'python:3.11-slim' } }
          steps {
            sh 'echo "Building docs..."'
            sh 'pip install sphinx && sphinx-build docs/ build/docs'
          }
        }
      }
    }
  }
}

为什么这样配置能解决你的问题？ #

• agent none：全局禁用默认agent，强制每个并行分支启动独立的Docker容器，不会复用同一个环境。
• 嵌套子stage：把需要共享同一容器的阶段（比如Prepare和Build，因为Build依赖Prepare安装的依赖）放到同一个分支的子stage里，既保证环境复用，又能在Blue Ocean里看到清晰的阶段层级。
• 并行分支独立展示：在Blue Ocean界面中，你会看到三个并行的进度块，其中Build Workflow块里还会展开Prepare Dependencies和Build Application两个子阶段，每一步的状态都一目了然，不会再合并成模糊的一团。

额外注意事项 #

• 如果需要不同的Python版本，直接替换image参数即可（比如python:3.10-slim）。
• 确保Jenkins服务器已配置Docker，且Jenkins用户拥有Docker操作权限（比如加入docker用户组）。
• 容器间的文件共享必须用stash/unstash，因为每个Docker容器的工作区是独立的，默认不会共享文件。

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