如何在声明式Jenkinsfile中定义多代理并实现Stage并行执行？

你提到的问题很常见，先直接给结论：必须使用parallel块，因为声明式Jenkins Pipeline的单个Stage默认只能绑定一个代理节点，要让同一段逻辑在多个节点上同时运行，就得通过并行子阶段来实现。

为什么你之前的尝试无效？ #

先解释下你用的两种标签语法的问题：

• agent { label "dev6 && dev7" }：这个是要求Jenkins找到同时拥有dev6和dev7两个标签的节点，显然你的两个Slave是分别带一个标签的，所以根本找不到符合条件的节点，执行会失败或者卡住。
• agent { label "dev6 || dev7" }：这个是找拥有dev6或dev7标签的任意一个节点，Jenkins会自动选择第一个可用的节点，所以只会在其中一个节点上运行，不会并行。

正确的实现方式 #

下面是完整的声明式Jenkinsfile示例，实现名为abc的Stage同时在dev6和dev7代理上并行执行xyz()函数：

pipeline {
    agent none // 全局不指定代理，由各个子阶段自己指定
    stages {
        stage('abc') {
            parallel {
                stage('Run on dev6') {
                    agent { label 'dev6' }
                    steps {
                        script {
                            xyz() // 调用你的xyz()函数
                        }
                    }
                }
                stage('Run on dev7') {
                    agent { label 'dev7' }
                    steps {
                        script {
                            xyz() // 调用你的xyz()函数
                        }
                    }
                }
            }
        }
        // 其他阶段...
    }
}

// 假设你的xyz()函数定义在这里
def xyz() {
    echo "Executing xyz() on node: ${env.NODE_NAME}"
    // 这里写你的函数逻辑
}

关键说明 #

1. 全局agent none：避免全局指定代理，让每个并行子阶段自己绑定对应的节点。
2. parallel块嵌套在abcStage内：把原来的单个Stage拆分为两个并行的子Stage，每个子Stage指定对应的代理标签。
3. script块：如果xyz()是自定义的Groovy函数，需要放在script块中执行（声明式Pipeline的steps里默认只能用Jenkins内置步骤，自定义函数需要包裹在script里）。

如果未来你需要扩展到更多节点，可以用动态生成并行分支的方式（比如从列表循环生成），但针对当前固定两个节点的场景，直接写两个并行子Stage是最清晰易维护的方案。

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