如何为Jenkins Multi-branch Pipeline程序化配置分支扫描规则？

直接精确指定分支 #

分支名称过滤规则支持精确匹配，你直接把原来的feature/*改成具体分支名就行，比如feature/ticket-123-fix-this。要是需要同时指定多个，用逗号分隔，比如feature/ticket-123-fix-this,feature/ticket-456-add-new——这种方式最直接，适合临时只跑特定分支的场景。

在Jenkinsfile里做动态分支校验 #

如果需要更灵活的程序化控制，直接在Jenkinsfile里加判断逻辑，只让指定分支执行流水线：

pipeline {
    agent any
    stages {
        stage('校验分支权限') {
            steps {
                script {
                    // 这里可以把允许的分支列表存在配置文件或者从外部拉取
                    def allowedBranches = ['feature/ticket-123-fix-this', 'feature/ticket-456-add-new']
                    if (!allowedBranches.contains(env.BRANCH_NAME)) {
                        error "当前分支 ${env.BRANCH_NAME} 不在允许构建列表里，终止流水线"
                    }
                }
            }
        }
        stage('构建') {
            steps {
                echo '开始执行构建步骤...'
            }
        }
    }
}

这种方式的好处是分支列表可以和代码一起维护，不用每次去Jenkins界面改配置，还能结合外部配置中心动态调整允许的分支。

用Jenkins API批量修改过滤规则 #

如果要自动化批量更新多分支流水线的过滤配置，用Jenkins REST API就能搞定：

1. 先拉取目标流水线的配置文件：

curl -u 你的用户名:密码 http://你的Jenkins地址/job/你的多分支流水线名/config.xml

2. 找到XML里的<includes>节点，把原来的feature/*替换成具体分支，比如：

<includes>feature/ticket-123-fix-this,feature/ticket-456-add-new</includes>

3. 把修改后的配置推回Jenkins：

curl -u 你的用户名:密码 -X POST -H "Content-Type: text/xml" --data-binary @修改后的config.xml http://你的Jenkins地址/job/你的多分支流水线名/config.xml

这种方法适合写脚本定时更新，比如结合工单系统，自动把需要构建的分支加入过滤列表。

额外建议 #

• 要是你的分支是和工单绑定的，可以结合工单状态自动调整允许构建的分支——比如只有待测试的工单分支才加入过滤，进一步减少无效扫描。
• 定期清理仓库里的废弃特性分支，从根源上减少Jenkins要处理的分支数量，降低系统负载。

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