Jenkins Pipeline：多代理节点并行执行函数及报错解决

首先得说清楚你原来代码报错的原因：你在script块里的闭包中用了agent这个Declarative Pipeline专属的语法，但script块属于Scripted Pipeline的执行环境，两种语法不能这么混用，所以才会抛出NoSuchMethodError找不到agent方法的错误。

下面给你两种可行的解决方案，按需选择：

方案一：动态生成并行任务（灵活适配节点数量） #

这种方式用Scripted Pipeline的node()语法来指定节点，能根据你定义的节点列表动态生成并行任务，非常适合需要调整节点数量的场景：

// 定义需要的节点标签列表：2个rhel6，3个rhel7
def slaveList = ['rhel6', 'rhel6', 'rhel7', 'rhel7', 'rhel7']

pipeline {
    agent any
    stages {
        stage('并行执行任务') {
            steps {
                script {
                    def parallelTasks = [:]
                    
                    // 遍历节点列表，为每个标签生成一个并行任务
                    slaveList.eachWithIndex { label, index ->
                        // 给每个任务起唯一名称，避免并行键冲突
                        def taskName = "Task-${index}-${label}"
                        parallelTasks[taskName] = {
                            // 用node()指定对应标签的节点
                            node(label) {
                                echo "当前运行节点标签：${label}，节点名称：${env.NODE_NAME}"
                                myFunc()
                            }
                        }
                    }
                    
                    // 启动所有并行任务
                    parallel parallelTasks
                }
            }
        }
    }
}

// 示例业务函数，替换成你的实际逻辑
def myFunc() {
    echo "正在执行myFunc..."
    // 这里添加你的业务代码，比如命令执行、文件处理等
}

关键说明： #

• 用node(label)替代agent：在script块中必须使用Scripted Pipeline的节点分配语法，这样就能正确找到对应标签的节点。
• 唯一任务名称：通过eachWithIndex给每个并行任务生成唯一名称，确保Parallel步骤的键不重复（Jenkins要求并行任务的键必须唯一）。
• 动态适配：如果后续需要调整rhel6/rhel7的节点数量，只需要修改slaveList即可，无需改动其他代码。

方案二：纯Declarative Pipeline写法（结构清晰） #

如果更倾向于纯Declarative语法，也可以手动定义每个并行Stage，这种方式结构更直观，适合节点数量固定的场景：

pipeline {
    agent any
    stages {
        stage('并行执行任务') {
            parallel {
                stage('RHEL6节点1') {
                    agent { label 'rhel6' }
                    steps {
                        myFunc()
                    }
                }
                stage('RHEL6节点2') {
                    agent { label 'rhel6' }
                    steps {
                        myFunc()
                    }
                }
                stage('RHEL7节点1') {
                    agent { label 'rhel7' }
                    steps {
                        myFunc()
                    }
                }
                stage('RHEL7节点2') {
                    agent { label 'rhel7' }
                    steps {
                        myFunc()
                    }
                }
                stage('RHEL7节点3') {
                    agent { label 'rhel7' }
                    steps {
                        myFunc()
                    }
                }
            }
        }
    }
}

def myFunc() {
    echo "正在执行myFunc，当前节点：${env.NODE_NAME}"
}

关键说明： #

• 每个并行Stage独立指定agent：在Declarative的Parallel块中，每个子Stage可以单独设置agent，这样就能分别指定rhel6和rhel7的节点。
• 结构清晰：所有并行任务一目了然，但如果需要调整节点数量，就得手动添加/删除Stage，灵活性稍差。

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