如何配置Jenkins多分支流水线拉取指定额外分支用于提交对比

方案1：通过Git插件配置Ref Spec（全局/流水线级） #

在多分支流水线的源码管理配置中，自定义Git的Ref Spec，仅拉取当前构建分支、main和develop分支，避免拉取全部分支：

• Ref Spec 填写：

  +refs/heads/main:refs/remotes/origin/main +refs/heads/develop:refs/remotes/origin/develop +refs/heads/${BRANCH_NAME}:refs/remotes/origin/${BRANCH_NAME}
  

• 原理：+表示强制更新本地引用，refs/heads/xxx对应远程分支，映射到本地refs/remotes/origin/xxx；${BRANCH_NAME}是Jenkins多分支流水线的内置变量，自动替换为当前构建的分支名。
• 同时确保在Jenkins中配置了Git仓库的凭据，无需在构建服务器本地存储凭据。

方案2：在Jenkinsfile中使用自定义Checkout步骤 #

如果需要在流水线脚本中完全控制拉取行为，直接编写checkout步骤，指定Ref Spec和Jenkins存储的凭据：

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                checkout([
                    $class: 'GitSCM',
                    branches: [[name: "${BRANCH_NAME}"]],
                    userRemoteConfigs: [[
                        url: '你的Git仓库URL',
                        credentialsId: 'Jenkins中配置的凭据ID', // 引用Jenkins存储的凭据
                        refspec: '+refs/heads/main:refs/remotes/origin/main +refs/heads/develop:refs/remotes/origin/develop +refs/heads/${BRANCH_NAME}:refs/remotes/origin/${BRANCH_NAME}'
                    ]]
                ])
            }
        }
        stage('对比提交') {
            steps {
                // 示例：对比当前分支与main分支的提交差异
                sh 'git log --oneline origin/main..HEAD'
            }
        }
    }
}

方案3：默认拉取后补充Fetch指定分支 #

如果多分支流水线默认已经拉取了当前分支，只需补充拉取main和develop，可以添加专门的fetch步骤，并用Jenkins凭据完成认证：

pipeline {
    agent any
    stages {
        stage('Checkout Current Branch') {
            steps {
                checkout scm // 使用默认的多分支checkout逻辑
            }
        }
        stage('Fetch Main & Develop') {
            environment {
                // 从Jenkins凭据中提取账号密码
                GIT_CREDS = credentials('你的凭据ID')
            }
            steps {
                script {
                    // 临时配置Git凭据助手，避免手动输入密码
                    sh 'git config credential.helper "!f() { echo username=${GIT_CREDS_USR}; echo password=${GIT_CREDS_PSW}; }; f"'
                    // 仅fetch指定分支到本地远程引用
                    sh 'git fetch origin main:origin/main develop:origin/develop'
                    // 清理临时凭据配置
                    sh 'git config --unset credential.helper'
                }
            }
        }
        stage('对比提交') {
            steps {
                // 示例：对比当前分支与develop分支的文件差异
                sh 'git diff origin/develop HEAD --name-only'
            }
        }
    }
}

注意事项 #

• 确保Jenkins中已正确配置Git仓库的凭据（用户名/密码或SSH密钥），凭据ID要与脚本中的配置一致。
• 三个方案都不会拉取仓库的所有分支，仅同步指定的三个分支，适合大仓库场景。

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