求助：Jenkins单仓CI流水线不同分支差异化并发构建限制配置方案

我刚好有过配置monorepo Jenkins CI流水线的经验，针对你遇到的分支差异化并发限制问题，这里有几个实用的解决方案：

方案1：用Lockable Resources插件实现精准资源控制 #

这个插件专门用来管理可抢占的构建资源，刚好能解决你「master分支不能使用PR占用的agent」的核心需求，同时兼顾并发限制：

• 全局配置步骤：在Jenkins全局设置里添加「Lockable Resources」，把每个agent都定义为独立资源（比如命名为agent-01、agent-02），每个资源的最大锁定数设为1。
• PR分支流水线配置：
  在每个并行stage里加入资源锁定逻辑，确保每个agent同一时间只跑一个PR stage：

  stage('PR Parallel Stage') {
    agent { label 'build-agent' }
    steps {
      lock(resource: "${env.NODE_NAME}") {
        // 执行PR分支的构建任务
        // 比如编译、测试等
      }
    }
  }
  

• master分支流水线配置：
  先通过Throttle插件限制master并发数为1，再用资源锁定确保只使用空闲agent：

  stage('Master Build') {
    options {
      throttle(categories: ['master-build'], maxConcurrent: 1)
    }
    agent { label 'build-agent' }
    steps {
      // 尝试锁定当前agent，0秒等待意味着直接跳过被占用的agent
      lock(resource: "${env.NODE_NAME}", acquireWaitTime: 0) {
        // 执行master分支的构建任务
      }
    }
  }
  

  这样master构建会自动寻找未被PR占用的空闲agent，同时保证同一时间只有一个master构建在运行。

方案2：无需新插件——临时标签+Throttle组合 #

如果你不想新增插件，可以通过动态添加/移除agent标签的方式实现agent隔离，配合Throttle控制master并发：

• PR分支流水线配置：
  运行阶段给当前agent添加临时标签，结束后自动移除：

  stage('PR Stage') {
    agent { label 'build-agent' }
    steps {
      script {
        // 给当前agent打上PR占用标记
        node.addLabel('pr-in-use')
        // 执行PR构建任务
        // ...
      }
    }
    post {
      always {
        // 不管成功失败，都移除标签
        node.removeLabel('pr-in-use')
      }
    }
  }
  

• master分支流水线配置：
  指定只选择没有pr-in-use标签的agent，同时用Throttle限制并发：

  stage('Master Build') {
    options {
      throttle(categories: ['master-build'], maxConcurrent: 1)
    }
    agent { label 'build-agent && !pr-in-use' }
    steps {
      // 执行master分支的构建任务
      // ...
    }
  }
  

  这个方案轻量灵活，依赖Jenkins原生的节点标签功能，不需要额外插件。

方案3：应急hack方案（不推荐生产使用） #

如果以上方案都暂时无法实施，可以通过脚本遍历节点状态，检查是否有PR构建在运行，再结合milestone控制master并发。不过这个实现起来繁琐，且稳定性较差，只适合临时应急场景。

总结 #

优先推荐方案1（Lockable Resources），它的资源锁定逻辑更清晰，适合复杂的monorepo并发场景；如果不想新增插件，方案2是轻量有效的替代方案。

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