Jenkins并行Pipeline配置：SVN同步与代理单次预构建需求

我来帮你搞定这个Jenkins Pipeline的问题！你需要实现两个核心需求：一是把SVN同步到指定变更列表，二是每个代理节点不管跑多少并行任务，预构建步骤只执行一次。下面是具体的解决方案和优化建议：

• SVN指定变更列表同步：在SVN checkout步骤中明确指定要拉取的变更列表号，确保代码版本准确。
• 代理预构建步骤仅执行一次：通过节点级别的标记判断，让同一个代理节点上的所有任务只执行一次预构建操作，避免重复消耗资源。

pipeline {
    agent none
    stages {
        stage('Parallel Multi-Config Builds') {
            failFast true
            parallel {
                stage('Release Build') {
                    agent { label "windows" }
                    steps {
                        // 预构建步骤：每个代理仅执行一次
                        script {
                            // 用节点全局目录的标记文件判断是否已执行预构建
                            def preBuildMarker = "${env.NODE_HOME}/.prebuild_completed"
                            if (!fileExists(preBuildMarker)) {
                                echo "=== 执行代理专属预构建步骤（仅首次运行） ==="
                                // 这里替换成你的实际预构建逻辑，比如环境初始化、依赖安装等
                                bat "choco install nodejs --version=18.17.0 -y"
                                // 创建标记文件，标记该代理已完成预构建
                                bat "echo Prebuild completed on %COMPUTERNAME% > ${preBuildMarker}"
                            } else {
                                echo "=== 该代理已完成预构建，跳过步骤 ==="
                            }
                        }

                        // SVN同步到指定变更列表
                        checkout([
                            $class: 'SubversionSCM',
                            additionalCredentials: [],
                            excludedCommitMessages: '',
                            excludedRegions: '',
                            excludedRevprop: '',
                            excludedUsers: '',
                            filterChangelog: false,
                            ignoreDirPropChanges: false,
                            includedRegions: '',
                            locations: [
                                [
                                    credentialsId: 'svn-credentials-id', // 替换成你的SVN凭证ID
                                    depthOption: 'infinity',
                                    ignoreExternalsOption: true,
                                    local: '.',
                                    remote: 'https://your-svn-repo-url/trunk', // 替换成你的SVN仓库地址
                                    changeSet: [changeSet: '12345'] // 替换成目标变更列表号
                                ]
                            ],
                            workspaceUpdater: [$class: 'UpdateUpdater']
                        ])

                        // Release配置构建步骤
                        echo "=== 开始Release配置构建 ==="
                        bat "msbuild YourProject.sln /p:Configuration=Release /p:Platform=x64"
                    }
                }

                stage('Debug Build') {
                    agent { label "windows" }
                    steps {
                        // 复用相同的预构建判断逻辑
                        script {
                            def preBuildMarker = "${env.NODE_HOME}/.prebuild_completed"
                            if (!fileExists(preBuildMarker)) {
                                echo "=== 执行代理专属预构建步骤（仅首次运行） ==="
                                bat "choco install nodejs --version=18.17.0 -y"
                                bat "echo Prebuild completed on %COMPUTERNAME% > ${preBuildMarker}"
                            } else {
                                echo "=== 该代理已完成预构建，跳过步骤 ==="
                            }
                        }

                        // 同步相同的SVN变更列表
                        checkout([
                            $class: 'SubversionSCM',
                            additionalCredentials: [],
                            excludedCommitMessages: '',
                            excludedRegions: '',
                            excludedRevprop: '',
                            excludedUsers: '',
                            filterChangelog: false,
                            ignoreDirPropChanges: false,
                            includedRegions: '',
                            locations: [
                                [
                                    credentialsId: 'svn-credentials-id',
                                    depthOption: 'infinity',
                                    ignoreExternalsOption: true,
                                    local: '.',
                                    remote: 'https://your-svn-repo-url/trunk',
                                    changeSet: [changeSet: '12345']
                                ]
                            ],
                            workspaceUpdater: [$class: 'UpdateUpdater']
                        ])

                        // Debug配置构建步骤
                        echo "=== 开始Debug配置构建 ==="
                        bat "msbuild YourProject.sln /p:Configuration=Debug /p:Platform=x64"
                    }
                }
            }
        }
    }
    post {
        cleanup {
            // 可选：若需要定期重置预构建标记，可在此添加清理逻辑
            // script {
            //     def preBuildMarker = "${env.NODE_HOME}/.prebuild_completed"
            //     if (fileExists(preBuildMarker)) {
            //         deleteFile preBuildMarker
            //     }
            // }
        }
    }
}

为了避免重复代码，你可以把预构建判断逻辑封装到Jenkins共享库中：

1. 在共享库中创建vars/preBuildOnce.groovy文件：

def call() {
    def preBuildMarker = "${env.NODE_HOME}/.prebuild_completed"
    if (!fileExists(preBuildMarker)) {
        echo "=== 执行代理专属预构建步骤（仅首次运行） ==="
        // 这里写入你的预构建逻辑
        bat "choco install nodejs --version=18.17.0 -y"
        bat "echo Prebuild completed on %COMPUTERNAME% > ${preBuildMarker}"
    } else {
        echo "=== 该代理已完成预构建，跳过步骤 ==="
    }
}

2. 在Pipeline中直接调用：

pipeline {
    agent none
    stages {
        stage('Parallel Builds') {
            failFast true
            parallel {
                stage('Release') {
                    agent { label "windows" }
                    steps {
                        preBuildOnce() // 直接调用共享库函数
                        checkout(/* SVN配置 */)
                        bat "Release构建命令"
                    }
                }
                stage('Debug') {
                    agent { label "windows" }
                    steps {
                        preBuildOnce()
                        checkout(/* SVN配置 */)
                        bat "Debug构建命令"
                    }
                }
            }
        }
    }
}

• 标记文件位置：使用${env.NODE_HOME}（代理节点的Jenkins主目录）存储标记文件，确保同一个节点上的所有任务共享这个标记；如果用${env.WORKSPACE}，则每个任务的工作空间会单独判断，不符合需求。
• 标记重置：如果需要定期让代理重新执行预构建（比如依赖版本更新），可以在post的cleanup阶段添加标记文件删除逻辑，或者用Jenkins定时任务清理节点上的标记文件。
• SVN变更列表：确保changeSet参数的格式正确，变更列表号要和SVN服务器上的一致。

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