如何让Jenkins多分支流水线复用同分支节点并优化增量构建

嘿，针对你提到的大型Git项目依赖Make增量构建的场景，这两个需求完全可以通过Jenkins流水线的节点绑定和状态追踪来实现——核心思路是让特定分支与构建节点建立关联标记，同时让流水线启动时优先查找该分支上次使用的节点，从而保留Make的构建缓存，避免全量构建的耗时。

1. 让同一分支持续复用同一构建节点 #

要实现同一分支固定复用某个节点，你可以通过分支专属节点标记+持久化状态记录来完成，具体有两种实用方案：

方案A：用环境变量追踪分支-节点映射 #

这种方案无需额外插件，通过流水线脚本记录每个分支的上次使用节点，下次构建时优先选用：

pipeline {
  agent none
  stages {
    stage('Assign Build Node') {
      steps {
        script {
          // 定义分支专属的节点记录键名
          def nodeRecordKey = "LAST_NODE_${env.BRANCH_NAME}"
          // 获取上次构建记录的节点名称
          def targetNode = currentBuild.getBuildVariables().get(nodeRecordKey) ?: null

          // 检查目标节点是否存在且在线
          def isNodeAvailable = targetNode ? (Jenkins.instance.getNode(targetNode)?.toComputer()?.isOnline() ?: false) : false

          if (isNodeAvailable) {
            // 复用上次的节点
            node(targetNode) {
              // 更新当前节点到构建变量，供下次使用
              currentBuild.setDisplayName("Running on ${targetNode}")
              env.set(nodeRecordKey, env.NODE_NAME)
              runBuildSteps()
            }
          } else {
            // Fallback到任意可用的构建节点（这里用标签筛选）
            node('build-node') {
              env.set(nodeRecordKey, env.NODE_NAME)
              runBuildSteps()
            }
          }
        }
      }
    }
  }
}

// 封装通用的构建步骤（复用代码）
def runBuildSteps() {
  // 仅在首次构建或强制清理时清空工作区，否则保留缓存
  if (!currentBuild.previousBuild || env.FORCE_CLEAN == 'true') {
    cleanWs()
  }
  checkout scm
  sh 'make build test'
}

方案B：用Lockable Resources插件锁定节点 #

如果你的分支数量固定，可使用Lockable Resources插件给每个构建节点创建专属锁定资源，让分支构建时独占该节点：

1. 安装Lockable Resources插件后，在Jenkins全局配置中添加资源（比如lock-node-1对应节点node-1）
2. 在流水线中按分支锁定对应资源：

pipeline {
  agent none
  stages {
    stage('Lock & Assign Node') {
      steps {
        lock(resource: "lock-${env.BRANCH_NAME}", inversePrecedence: true) {
          node('build-node') {
            runBuildSteps()
          }
        }
      }
    }
  }
}

2. 优先选用分支上次使用的构建节点（支持增量构建） #

这个需求的核心是保留节点上的Make构建缓存，除了上面的节点选择逻辑，还要注意以下关键配置：

• 禁用默认工作区清理：Jenkins默认会在构建后清理工作区，你需要在流水线中添加条件清理逻辑（如上面runBuildSteps中的cleanWs判断），只在首次构建或手动触发清理时清空缓存。
• 持久化节点工作区：如果使用动态节点（如K8s Pod），需要挂载持久化卷到工作区目录，避免Pod销毁后缓存丢失；如果是静态节点，确保磁盘空间足够存储缓存文件。
• 处理节点离线的Fallback：一定要添加节点不可用时的备选逻辑，避免分支构建因单个节点离线而失败。

额外注意事项 #

• 对于长期不活跃的分支，建议定期清理其节点上的缓存，释放磁盘空间。
• 如果使用多分支流水线的分支扫描功能，确保每个分支的Job能独立存储节点记录（上面的currentBuild变量会自动按分支Job区分）。
• 可以给节点添加标签（如high-memory），在Fallback时优先选择满足资源要求的节点。

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