如何使用Jenkins声明式语法在两个不同代理上运行相同任务

我完全懂你的需求啦——要把两个运行在不同OS上、构建步骤完全一致但工具（JDK/Maven）和代理不同的任务，合并成一个能按需选择操作系统的声明式Jenkins Pipeline对吧？刚好我之前也处理过类似场景，用参数化构建+条件化代理选择+阶段内工具绑定就能完美解决，完全符合声明式语法的要求，给你一步步拆解：

核心思路 #

1. 先做参数化配置，让用户手动选择要构建的目标操作系统；
2. 根据选择的OS自动匹配对应的Jenkins代理节点；
3. 在构建阶段里，根据OS选择预先配置好的对应版本JDK和Maven；
4. 复用完全一致的构建步骤，仅适配不同OS的执行命令（sh/bat）。

完整示例代码 #

pipeline {
    agent none // 先不指定代理，后面根据参数动态选择
    parameters {
        choice(
            name: 'TARGET_OS',
            choices: ['Linux', 'Windows'],
            description: '选择要执行构建的目标操作系统'
        )
    }
    stages {
        stage('Build') {
            // 根据参数选择对应的代理节点（前提是你的代理已经打好对应标签）
            agent {
                label "${TARGET_OS == 'Linux' ? 'linux-build-agent' : 'windows-build-agent'}"
            }
            // 根据OS绑定对应的JDK和Maven（需提前在Jenkins全局工具配置中配置好这些工具）
            tools {
                jdk "${TARGET_OS == 'Linux' ? 'JDK_11_LINUX' : 'JDK_11_WINDOWS'}"
                maven "${TARGET_OS == 'Linux' ? 'MAVEN_3_8_6_LINUX' : 'MAVEN_3_8_6_WINDOWS'}"
            }
            steps {
                script {
                    // 复用完全一致的构建命令，自动适配OS的执行方式
                    def buildCommand = 'mvn clean package -DskipTests'
                    if (isUnix()) {
                        sh buildCommand
                    } else {
                        bat buildCommand
                    }
                }
                // 这里可以继续添加你其他一致的构建步骤，比如归档产物等
                archiveArtifacts artifacts: 'target/*.jar', fingerprint: true
            }
        }
    }
    post {
        always {
            echo "构建完成，目标操作系统：${TARGET_OS}"
        }
    }
}

关键细节说明 #

• 参数化构建：用choice参数让用户明确选择OS，避免歧义；
• 动态代理选择：通过agent { label ... }里的三元表达式，根据参数值匹配对应的代理节点标签（记得给你的Linux/Windows代理分别打上linux-build-agent、windows-build-agent这类标签）；
• 阶段内工具绑定：声明式语法允许在stage内部使用tools块，这里同样用三元表达式根据OS选择预先在Jenkins全局配置好的工具（工具名称要和你配置的完全一致，比如Linux的JDK你命名为JDK_11_LINUX，Windows的命名为JDK_11_WINDOWS）；
• 通用构建步骤：用script块结合isUnix()方法自动判断当前代理的OS，执行对应的sh或bat命令，这样构建逻辑完全复用，不用写两套步骤。

额外优化建议 #

如果你的工具命名有规律（比如后缀都是对应OS），还可以简化工具选择的逻辑，比如：

tools {
    jdk "JDK_11_${TARGET_OS.toUpperCase()}"
    maven "MAVEN_3_8_6_${TARGET_OS.toUpperCase()}"
}

这样代码更简洁，后续新增OS也更容易维护。

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