GitLab集成Jenkins多分支流水线：如何发现新分支且不触发自动构建

核心配置调整步骤 #

1. 配置Jenkins分支扫描规则，关闭自动构建触发 #

在多分支流水线项目的配置页面：

• 进入「分支来源」模块，确保GitLab仓库连接正常
• 打开「高级」设置，设置扫描间隔（比如每10分钟一次），让Jenkins定期检测GitLab的新分支并同步列表
• 在「行为」区域添加「发现分支」规则（可选择「所有分支」或自定义匹配规则），确保新分支能被识别
• 取消勾选「扫描到新分支时自动构建」类选项（不同版本名称可能略有差异，比如「自动构建新发现的分支」）

2. 调整GitLab Webhook触发事件 #

不要直接关闭Webhook，而是精准控制触发类型：

• 在GitLab仓库的「设置」-「集成」中找到对应Jenkins的Webhook
• 仅勾选「分支/标签创建」事件，取消「推送事件」「合并请求事件」等会触发自动构建的选项
• 保存设置后，新分支创建时GitLab会通知Jenkins立即扫描同步，但不会触发构建

3. 在Jenkinsfile中禁用自动触发逻辑 #

如果流水线定义里有自动触发配置，直接注释或删除：

pipeline {
    agent any
    triggers {
        // 注释所有自动触发规则，比如定时任务、GitLab触发等
        // cron('H/15 * * * *')
        // gitlab(triggerOnPush: false, triggerOnMergeRequest: false)
    }
    stages {
        stage('Build') {
            steps {
                echo '仅支持手动触发构建'
            }
        }
    }
}

4. 项目级关闭自动构建触发器 #

在多分支流水线的「构建触发器」页面：

• 取消所有自动触发选项，比如「GitLab hook trigger for GITScm polling」
• 仅保留手动构建入口，确保只有点击「立即构建」才会执行流水线

验证效果 #

• 在GitLab创建新分支，等待Jenkins自动扫描（或手动触发一次分支扫描），确认新分支出现在Jenkins项目列表中
• 检查新分支是否未自动启动构建，只有手动点击构建按钮才会执行流水线

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