Jenkins声明式流水线：标签不存在时重试下游任务或触发分支扫描

一、主动触发BuildJob的多分支扫描 #

你可以在DeployJob里先触发BuildJob对应的多分支流水线扫描，确保新标签被识别后，再去触发对应tag的任务。常用两种方式：

1. 使用流水线内置步骤multibranchPipelineScan #

只要你的Jenkins装了Pipeline Multibranch插件（默认一般都有），就能直接用这个步骤触发扫描：

// 触发BuildJob多分支项目的仓库扫描
multibranchPipelineScan job: 'BuildJob'

执行后Jenkins会立刻同步BuildJob关联仓库的新标签、分支。

2. 通过Jenkins API触发扫描（无插件限制场景） #

如果上述步骤不可用，也可以用curl调用Jenkins的REST API触发扫描，注意提前配置好权限凭证：

sh """
curl -X POST \
  -u \${JENKINS_USER}:\${JENKINS_TOKEN} \
  \${JENKINS_URL}/job/BuildJob/scan
"""

这里的JENKINS_USER和JENKINS_TOKEN可以提前在流水线里配置为全局凭证，或者用Jenkins内置的环境变量。

二、标签任务不存在时的重试机制 #

如果扫描后仍有延迟，或者需要处理扫描未覆盖的情况，可以给触发BuildJob的逻辑加重试逻辑，两种常用实现：

1. 固定次数重试 #

用retry步骤包裹触发逻辑，失败后重试指定次数，每次重试前可再次扫描：

retry(3) { // 最多重试3次
  // 先扫描确保标签被识别
  multibranchPipelineScan job: 'BuildJob'
  // 等待20秒让扫描完成（可根据仓库大小调整）
  sleep(time: 20, unit: 'SECONDS')
  // 触发目标tag的BuildJob
  build job: "BuildJob/${buildConfig.deployConfig.tag}", parameters: [
    [$class: 'BooleanParameterValue', name: 'DEPLOY', value: true]
  ]
}

2. 等待直到任务存在再触发 #

用waitUntil步骤循环检查目标任务是否存在，直到存在再触发，避免盲目重试：

waitUntil {
  multibranchPipelineScan job: 'BuildJob'
  sleep(time: 15, unit: 'SECONDS')
  // 检查目标tag的任务是否存在（需流水线有脚本审批权限）
  def jobExists = Jenkins.instance.getItemByFullName("BuildJob/${buildConfig.deployConfig.tag}") != null
  if (jobExists) {
    return true
  } else {
    echo "标签${buildConfig.deployConfig.tag}对应的任务还未被扫描到，等待后重试..."
    return false
  }
}
// 任务存在后触发
build job: "BuildJob/${buildConfig.deployConfig.tag}", parameters: [
  [$class: 'BooleanParameterValue', name: 'DEPLOY', value: true]
]

如果没有脚本权限，也可以用API检查任务是否存在：

waitUntil {
  multibranchPipelineScan job: 'BuildJob'
  sleep(time: 15, unit: 'SECONDS')
  def jobExists = sh(
    script: "curl -s -u \${JENKINS_USER}:\${JENKINS_TOKEN} \${JENKINS_URL}/job/BuildJob/job/${buildConfig.deployConfig.tag}/api/json | grep -q \"name\"",
    returnStatus: true
  ) == 0
  if (jobExists) {
    return true
  } else {
    echo "标签${buildConfig.deployConfig.tag}对应的任务还未被扫描到，等待后重试..."
    return false
  }
}

三、注意事项 #

• 扫描和等待的时间要根据仓库大小、Jenkins性能调整，避免过短导致扫描未完成，或过长浪费时间。
• 使用Jenkins.instance或API时，确保流水线有足够权限，必要时联系管理员配置权限或审批脚本。
• 如果经常出现钩子未处理的情况，建议排查仓库Webhook配置是否正常，从根源减少对手动扫描的依赖。

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