如何用单个Jenkins Pipeline Job构建同一Git仓库的多前缀分支？

当然可行！这种场景在日常CI流程里非常常见，完全可以通过单个Jenkins Pipeline Job实现，下面是具体的实现方案：

一、核心思路 #

通过参数化构建配合Pipeline脚本中的分支遍历逻辑，让Job可以识别并构建符合指定前缀的Git分支，同时也支持手动指定单个分支进行构建，兼顾灵活性和自动化需求。

二、具体步骤与代码示例 #

1. 配置Job的基础参数 #

先给你的Pipeline Job添加几个实用参数，方便后续灵活控制：

• 添加字符串参数：命名为BRANCH_PREFIX，默认值设为feature/（可根据你的实际分支前缀调整），用来指定要筛选的分支前缀。
• 添加布尔参数：命名为BUILD_ALL_MATCHING，默认勾选，用来控制是构建所有符合前缀的分支，还是只构建单个分支。
• 添加字符串参数：命名为SPECIFIC_BRANCH，默认留空，当不勾选BUILD_ALL_MATCHING时，用来指定具体要构建的分支名称。

2. Pipeline脚本实现 #

下面是完整的可复用Pipeline脚本，包含分支扫描、筛选、遍历构建的完整逻辑：

pipeline {
    agent any
    parameters {
        string(name: 'BRANCH_PREFIX', defaultValue: 'feature/', description: '要构建的分支前缀，例如feature/、bugfix/')
        booleanParam(name: 'BUILD_ALL_MATCHING', defaultValue: true, description: '是否构建所有符合前缀的分支')
        string(name: 'SPECIFIC_BRANCH', defaultValue: '', description: '不勾选全量构建时，输入单个分支名称')
    }
    
    stages {
        stage('筛选目标分支') {
            steps {
                script {
                    // 获取Git仓库所有远程分支（无需克隆全仓库，提升效率）
                    def allBranches = sh(
                        script: 'git ls-remote --heads https://your-git-repo-url.git | awk \'{print $2}\' | sed \'s/refs\\/heads\\///\'',
                        returnStdout: true
                    ).trim().split('\n')
                    
                    // 根据参数筛选分支
                    def targetBranches = []
                    if (params.BUILD_ALL_MATCHING) {
                        targetBranches = allBranches.findAll { it.startsWith(params.BRANCH_PREFIX) }
                    } else {
                        if (params.SPECIFIC_BRANCH) {
                            targetBranches.add(params.SPECIFIC_BRANCH)
                        } else {
                            error '请勾选「构建所有分支」，或输入具体分支名称'
                        }
                    }
                    
                    // 校验分支是否存在
                    if (targetBranches.isEmpty()) {
                        error "未找到符合前缀「${params.BRANCH_PREFIX}」的分支，请检查前缀是否正确"
                    }
                    
                    // 把目标分支存入环境变量，供后续阶段调用
                    env.TARGET_BRANCHES = targetBranches.join(',')
                }
            }
        }
        
        stage('执行分支构建') {
            steps {
                script {
                    def branches = env.TARGET_BRANCHES.split(',')
                    
                    // 可选：如果想要并行构建多个分支，把下面的each改成parallel块即可
                    branches.each { branch ->
                        echo "===== 开始构建分支: ${branch} ====="
                        // 拉取对应分支代码
                        checkout scm: [
                            $class: 'GitSCM',
                            branches: [[name: branch]],
                            userRemoteConfigs: [[url: 'https://your-git-repo-url.git']]
                        ]
                        
                        // 替换成你的实际构建步骤，比如编译、测试、打包等
                        stage("分支${branch} - 编译构建") {
                            sh 'mvn clean package' // 示例：Maven项目构建
                            // 可添加其他步骤：上传制品到仓库、发送构建通知等
                        }
                    }
                }
            }
        }
    }
    
    post {
        success {
            echo "所有目标分支构建完成！"
        }
        failure {
            echo "部分分支构建失败，请查看对应分支的构建日志排查问题"
        }
    }
}

3. 关键细节优化 #

• 分支扫描效率：用git ls-remote命令直接获取远程分支列表，无需克隆整个仓库，尤其适合分支较多的大型仓库。
• 灵活匹配规则：如果需要更复杂的分支匹配（比如支持正则），可以把startsWith改成matches，例如it.matches(/release-v\d+\.\d+/)来匹配版本分支。
• 并行构建提速：如果想同时构建多个分支，把each循环改成parallel块，示例如下：

// 替换遍历构建的代码为并行构建
def parallelTasks = [:]
branches.each { branch ->
    parallelTasks["构建分支: ${branch}"] = {
        checkout scm: [/* 同上面的配置 */]
        sh 'mvn clean package'
    }
}
parallel parallelTasks

• 凭证安全：不要在脚本里硬编码Git仓库地址和密码，使用Jenkins的凭证管理功能，通过credentials()方法调用凭证。

三、额外触发方式建议 #

如果需要自动化触发构建，可以配合：

• 定时构建：设置每日/每周定时扫描符合前缀的分支并构建。
• Git Webhook：配置仓库的Webhook，当符合前缀的分支有新提交时，自动触发Job执行构建。

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