如何在Jenkins声明式流水线中并行构建所有代理且不关闭沙箱、避免重复代码？

嘿，我来帮你搞定这个问题！要在不关闭沙箱的前提下实现所有代理并行执行，同时避免代码冗余，咱们可以分两步走：先搞定并行执行的逻辑，再用合适的方式抽离重复代码。

一、沙箱下实现多代理并行执行 #

Jenkins声明式流水线的parallel块是核心，结合动态生成stage的方式，就能让所有目标代理同时跑任务。而且沙箱模式下完全支持这种写法，只要不调用被禁用的危险方法就行。

具体实现思路： #

1. 先定义你要用到的所有代理标签列表；
2. 用script块（沙箱允许）动态生成并行的stage集合；
3. 每个stage绑定对应的代理，执行任务逻辑。

示例代码：

pipeline {
    agent none
    stages {
        stage('Parallel Execution on All Agents') {
            steps {
                script {
                    // 定义所有要并行执行的代理标签
                    def agentLabels = ['agent-1', 'agent-2', 'agent-3', 'agent-4']
                    
                    // 动态生成并行stage
                    def parallelStages = agentLabels.collectEntries { label ->
                        ["Run on ${label}": {
                            node(label) {
                                // 这里放你要在每个代理上执行的任务
                                echo "Executing on agent: ${label}"
                                sh 'echo Hello from this agent!'
                                // 其他步骤：比如构建、测试等
                            }
                        }]
                    }
                    
                    // 启动并行执行
                    parallel parallelStages
                }
            }
        }
    }
}

这里用node(label)来指定每个并行任务的代理，完全符合沙箱的安全要求，不需要关闭沙箱。

二、避免代码冗余的最佳实践 #

既然每个代理上的操作几乎相同，咱们可以把重复的逻辑抽离出来，常用的方式有两种：流水线内函数定义 和 共享库（Shared Libraries）。

1. 流水线内函数定义（快速简单） #

如果只是当前流水线复用，直接在script块里定义一个函数，然后在每个并行stage里调用就行：

pipeline {
    agent none
    stages {
        stage('Parallel Execution on All Agents') {
            steps {
                script {
                    // 定义复用的任务逻辑函数
                    def runAgentTask(String agentLabel) {
                        node(agentLabel) {
                            echo "Starting task on ${agentLabel}"
                            sh 'npm install'
                            sh 'npm run test'
                            junit 'reports/**/*.xml'
                            echo "Task completed on ${agentLabel}"
                        }
                    }
                    
                    def agentLabels = ['agent-1', 'agent-2', 'agent-3']
                    def parallelStages = agentLabels.collectEntries { label ->
                        ["Run on ${label}": { runAgentTask(label) }]
                    }
                    
                    parallel parallelStages
                }
            }
        }
    }
}

这样所有重复的步骤都在runAgentTask函数里，改一次就能同步所有代理的逻辑，完美解决冗余问题。

2. 共享库（适合多流水线复用） #

如果你的多个流水线都需要这段逻辑，推荐用Jenkins共享库，把通用任务封装成可复用的步骤：

步骤1：创建共享库

在你的Git仓库里创建如下结构：

vars/
    runAgentTask.groovy

步骤2：实现共享库方法（runAgentTask.groovy）

def call(String agentLabel) {
    node(agentLabel) {
        echo "Starting task on ${agentLabel}"
        sh 'npm install'
        sh 'npm run test'
        junit 'reports/**/*.xml'
        echo "Task completed on ${agentLabel}"
    }
}

步骤3：在流水线中引用共享库

@Library('your-shared-library') _ // 替换成你的共享库名称

pipeline {
    agent none
    stages {
        stage('Parallel Execution on All Agents') {
            steps {
                script {
                    def agentLabels = ['agent-1', 'agent-2', 'agent-3']
                    def parallelStages = agentLabels.collectEntries { label ->
                        ["Run on ${label}": { runAgentTask(label) }]
                    }
                    
                    parallel parallelStages
                }
            }
        }
    }
}

共享库的方式不仅能减少当前流水线的冗余，还能让多个流水线复用同一套逻辑，维护起来更方便，而且沙箱下完全支持（只要共享库被标记为“允许在沙箱中使用”）。

注意事项 #

• 确保你的Jenkins版本支持声明式流水线的动态并行（一般2.100+版本都没问题）；
• 共享库需要在Jenkins全局配置里添加，并勾选“允许在沙箱中使用”；
• 如果代理标签是从配置或参数获取的，只要是安全的输入，沙箱下也能正常使用。

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