Jenkins声明式流水线如何实现用户选择特定分支构建？

你的需求完全可以实现，而且能优化得更简洁高效——不需要先拉取全部分支再选择，直接从远程仓库获取分支列表作为选项即可，避免冗余的代码拉取步骤。

下面是优化后的声明式Pipeline代码，兼顾了简洁性和实用性：

pipeline {
    agent any
    stages {
        stage('选择构建分支') {
            steps {
                script {
                    // 直接从远程仓库拉取分支列表，过滤冗余信息并排序去重
                    def remoteBranches = sh(
                        returnStdout: true,
                        script: 'git ls-remote --heads git@github.com:repo/notification-sender.git | awk \'{print $2}\' | sed \'s/refs\\/heads\\///\' | sort -u'
                    ).trim().split('\n')
                    
                    // 弹出用户选择框，将选中分支存入环境变量
                    env.BRANCH_TO_BUILD = input(
                        message: '请选择要构建的分支',
                        ok: '开始构建',
                        parameters: [
                            choice(
                                name: 'BRANCH_TO_BUILD',
                                choices: remoteBranches,
                                description: '选择目标分支'
                            )
                        ]
                    )
                }
            }
        }
        stage('检出选中分支') {
            steps {
                checkout([
                    $class: 'GitSCM',
                    branches: [[name: "*/${env.BRANCH_TO_BUILD}"]],
                    doGenerateSubmoduleConfigurations: false,
                    extensions: [
                        [$class: 'CloneOption', noTags: true, shallow: true]
                    ],
                    submoduleCfg: [],
                    userRemoteConfigs: [
                        [credentialsId: 'repo.notification-sender', url: 'git@github.com:repo/notification-sender.git']
                    ]
                ])
            }
        }
        // 可添加你的后续构建/测试阶段
        stage('构建项目') {
            steps {
                echo "正在构建分支: ${env.BRANCH_TO_BUILD}"
                // 这里替换为你的实际构建命令，比如 mvn clean package 或 npm run build
            }
        }
    }
    post {
        always {
            echo '执行节点清理'
            cleanWs()
        }
    }
}

关键优化点说明： #

1. 轻量获取分支列表：

   • 用git ls-remote --heads直接从远程仓库拉取分支元数据，不需要克隆整个仓库，节省时间和磁盘空间
   • 通过awk和sed过滤掉refs/heads/前缀，得到干净的分支名称，再排序去重保证选项整洁

2. 清晰的阶段拆分：

   • 把分支选择和代码检出拆分为独立阶段，逻辑更清晰，也方便后续调整或添加日志

3. 复用你原有的优化配置：

   • 保留了浅克隆（shallow: true）、不拉取标签（noTags: true）等配置，保证代码检出的效率

为什么原有方案可以优化？ #

你之前的方案先拉取全部分支再本地解析列表，会额外下载所有分支的代码，当仓库分支多、代码量大时，不仅耗时还会占用Jenkins节点的存储资源。直接从远程获取分支元数据的方式更轻量，尤其适合多用户多分支的场景。

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