Jenkins Pipeline 通过 parallel 指令在 stage 内并行执行多个测试任务，适用于相互独立的测试模块。需注意节点执行器资源充足，避免任务排队等待。

命令速用版

pipeline {
    agent any
    stages {
        stage('Parallel Tests') {
            parallel {
                stage('Test Module A') {
                    steps {
                        sh 'pytest tests/module_a'
                    }
                }
                stage('Test Module B') {
                    steps {
                        sh 'pytest tests/module_b'
                    }
                }
            }
        }
    }
}

为什么会这样

parallel 指令允许 Jenkins 调度器将包裹的多个 stage 分配给不同的执行器同时运行。不同于顺序执行，并行块内的任务没有先后依赖，只要资源可用就会立即启动。这种机制能充分利用多核 CPU 或分布式节点资源，显著减少流水线总耗时。

分步处理

1. 定义 Pipeline 结构：使用声明式语法 pipeline { } 包裹整个脚本，确保语法规范。
2. 编写 parallel 块：在某个 stage 的 steps 或直接在 stages 内（取决于嵌套需求）使用 parallel { }。
3. 配置独立 Stage：在 parallel 块内定义多个 stage('Name') { steps { ... } }，每个 stage 代表一个并行任务。
4. 分配代理资源：若任务需要不同环境，可在每个并行 stage 内指定 agent { label '...' }，否则继承全局 agent。
5. 添加触发条件（可选）：使用 when 指令控制特定并行任务是否执行，例如仅当代码变更时运行特定测试。

怎么验证是否生效

进入 Jenkins 任务构建页面，查看“阶段视图（Stage View）”或“蓝色海洋（Blue Ocean）”。若并行生效，多个子 stage 的时间条在时间轴上应呈现重叠状态，且总构建时长应接近耗时最长的那个子任务时长，而非所有任务时长之和。

常见坑

• 执行器不足：若节点执行器数量为 1，并行任务会退化为串行排队，需检查节点配置。
• 共享资源冲突：并行任务若操作同一文件或端口，会导致竞争失败，需确保测试数据隔离。
• 失败策略：默认情况下一个并行分支失败不会立即终止其他分支，若需快速失败可配置 failFast true。

常见问题

如何在并行任务中限制最大并发数？

可以在脚本中使用信号量（Semaphore）或自定义锁逻辑控制，但原生 parallel 块默认会尽可能并发，需依赖节点执行器数量限制。

并行任务中如何使用不同的 Agent？

在每个并行 stage 内部单独声明 agent { label 'specific-label' }，Jenkins 会调度对应标签的节点执行该分支。

如何确保并行任务全部完成后才执行后续步骤？

将后续步骤写在 parallel 块之外的下一个 stage 中，Jenkins 会自动等待并行块内所有任务结束后再进入后续阶段。

参考来源

• 你的知识库 - Jenkins 多任务有条件并发执行
• 你的知识库 - Jenkins 在 Debian 上如何实现多任务并行
• 你的知识库 - 利用 jenkins 中的 pipeline 能并行执行多个自动化任务
• 你的知识库 - Jenkins 全链路教程——并行任务与超时控制
• 你的知识库 - Jenkins 高级篇之 Pipeline 语法篇 -9-多个 stage 的关系：顺序和并行