如何追踪未引用master分支的Jenkins Job？

核心实现逻辑 #

你可以通过Jenkins内置的Groovy脚本能力，无侵入式实现所有Job启动时的分支校验，无需修改存量任务的配置或Jenkinsfile，具体实现分两种场景： #

1. 运行时触发校验（匹配你的告警需求） #

通过全局RunListener扩展点或者Pipeline共享库的预构建钩子，在所有Job启动时自动校验分支配置：

• 稳定分支清单可自定义，支持同时配置master、main等多个合规分支
• 核心校验代码示例：

// 预构建阶段自动执行的校验逻辑
def stableBranches = ['master', 'main']
def isNonCompliant = false
def currentJob = Jenkins.instance.getItemByFullName(env.JOB_NAME)
def runningBranch = ""

// 读取Git SCM配置的`Branch Specifier (blank for 'any')`值
if (currentJob.scm instanceof hudson.plugins.git.GitSCM) {
  currentJob.scm.branches.each { branch ->
    // 去除分支前缀、通配符前缀，拿到纯分支名
    runningBranch = branch.name.replace('refs/heads/', '').replace('*/', '')
    if (!stableBranches.contains(runningBranch)) {
      isNonCompliant = true
    }
  }
}

// 校验不通过则触发你已实现的Slack告警逻辑
if (isNonCompliant) {
  // 告警内容可自定义追加Job名、分支名、构建链接、触发人等信息
  sendSlackAlert(jobName: env.JOB_NAME, branch: runningBranch, buildUrl: env.BUILD_URL)
}

2. 存量Job批量排查 #

如果需要先清理已经配置了非稳定分支的存量任务，可以直接在Jenkins脚本控制台执行以下代码，一次性导出所有不合规Job：

def stableBranches = ['master', 'main']
def nonCompliantJobs = []

Jenkins.instance.getAllItems(Job.class).each { job ->
  if (job.scm instanceof hudson.plugins.git.GitSCM) {
    job.scm.branches.each { branch ->
      def cleanBranch = branch.name.replace('refs/heads/', '').replace('*/', '')
      if (!stableBranches.contains(cleanBranch) && !nonCompliantJobs.contains(job.fullName)) {
        nonCompliantJobs.add([name: job.fullName, branch: cleanBranch])
      }
    }
  }
}

// 输出结果
println "==== 不合规Job清单 ===="
nonCompliantJobs.each {
  println "Job名称：${it.name}，配置分支：${it.branch}"
}
println "合计找到${nonCompliantJobs.size()}个不合规任务"

适配特殊场景 #

• 如果有任务配置的是通配符分支规则（比如*/feature/*）或者Branch Specifier留空匹配任意分支，可以自行扩展校验规则，将这类场景也纳入告警范围
• 多分支Pipeline任务可以单独匹配env.BRANCH_NAME变量做校验，逻辑和上述代码一致

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