Jenkins构建队列合并pending jobs需求及实现方案咨询

有几种可行的实现方式，既可以用现成插件快速解决，也能基于你的思路做自定义开发：

一、用现成插件（推荐） #

直接用成熟插件能省掉不少开发成本：

• Build Blocker Plugin：配置规则后，当队列里已经存在同项目、同参数的pending任务时，会自动阻止新的相同任务进入队列，完美匹配你的需求。注意要在插件配置里明确参数匹配规则，确保只有参数完全一致的任务才会被拦截。
• Queue Cleanup Plugin：支持自定义清理逻辑，可设置“移除重复pending任务”，通过参数匹配保留最新或最早的任务，自动清理重复项。
• 如果是Pipeline项目，Pipeline Aggregator Plugin能让你在Jenkinsfile里直接写逻辑，检查队列中是否有同参数的pending任务，再决定是否触发新构建。

二、基于你的思路做自定义实现 #

你的拆分任务的思路完全可行，具体落地步骤如下：

1. 拆分任务角色
   • 把实际执行构建逻辑的任务封装成do_project，配置好所有需要的构建参数和执行步骤，设置为禁止手动触发，只允许通过脚本或其他任务调用。
   • 新建一个前端交互任务（比如叫trigger_do_project），作为用户触发的唯一入口，只负责检查队列和触发do_project。
2. 在交互任务中加队列检查逻辑
   在trigger_do_project里添加“Execute system Groovy script”步骤，用脚本检查队列中是否存在同参数的do_project pending任务：

   import hudson.model.*
   def queue = Jenkins.instance.queue
   def targetJobName = "do_project"
   def currentParams = build.buildVariableResolver.getValues()
   def hasMatchingPendingJob = false
   
   // 遍历队列查找匹配任务
   for (queueItem in queue.items) {
       if (queueItem.task.name == targetJobName) {
           def queueParams = queueItem.parameters
           def paramsMatch = true
           // 逐个对比参数
           for (entry in currentParams) {
               def queueParam = queueParams.find { it.name == entry.key }
               if (!queueParam || queueParam.value != entry.value) {
                   paramsMatch = false
                   break
               }
           }
           if (paramsMatch) {
               hasMatchingPendingJob = true
               break
           }
       }
   }
   
   // 决定是否触发新任务
   if (!hasMatchingPendingJob) {
       def targetJob = Jenkins.instance.getItem(targetJobName)
       targetJob.scheduleBuild2(0, new Cause.UserIdCause(), new ParametersAction(currentParams.values()))
       println "已触发新的do_project任务"
   } else {
       println "队列中已有相同参数的pending任务，无需重复触发"
   }
   

   注意：要给执行这个脚本的用户授予足够的权限（比如队列读取、任务触发权限）。
3. 优化体验：可以在交互任务的构建描述里添加提示，告诉用户是否触发了新任务，或者已有任务在队列中。

三、关键注意点 #

• 参数匹配要全覆盖：把所有构建参数（包括隐藏参数）都纳入匹配逻辑，别漏了任何一个，避免出现参数不同却被误合并的情况。
• 安全控制：自定义Groovy脚本需要Jenkins系统权限，要限制脚本的修改权限，防止恶意操作。
• 避免竞态：检查队列和触发任务之间可能存在极短的时间差，极端情况下可能出现重复触发，可以加个简单的锁机制（比如用临时文件或Jenkins全局变量）来规避。

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