如何让Jenkins串行拉取Declerative Pipeline的Git仓库以避免Git服务器过载？

你的问题核心是：Declarative Pipeline默认会在**执行器队列之外（Master端）**提前拉取Jenkinsfile对应的仓库，这就导致哪怕只有1个执行器，多个启动的任务也会同时触发Git克隆，进而压垮Git服务器。以下是几种可行的解决方法：

方法1：将仓库拉取操作移至执行器节点内 #

通过agent none避免在节点外自动拉取仓库，把拉取步骤放到指定执行器的阶段中，利用执行器的单队列特性，实现串行拉取：

pipeline {
  agent none
  stages {
    stage('拉取仓库与构建') {
      agent { label 'your-executor-label' } // 替换为你的执行器标签
      steps {
        // 手动执行仓库拉取，此操作会进入执行器队列，同一时间仅一个任务执行
        git url: '你的Git仓库地址', branch: '目标分支'
        
        // 后续构建步骤...
      }
    }
  }
}

方法2：用锁资源插件控制全局串行拉取 #

安装Lockable Resources Plugin插件，创建全局锁资源，让所有流水线的拉取步骤必须获取锁才能执行，确保同一时间仅一个任务克隆仓库：

1. 在Jenkins全局配置中，添加一个名为git-clone-lock的锁（资源数量设为1）；
2. 修改流水线脚本，在拉取前申请锁：

pipeline {
  agent any
  options {
    // 申请全局锁，未获取到则排队等待
    lock(resource: 'git-clone-lock', inversePrecedence: true)
  }
  stages {
    stage('拉取仓库') {
      steps {
        checkout scm // 拉取操作受锁控制，串行执行
        // 后续构建步骤...
      }
    }
  }
}

方法3：优化仓库拉取的辅助方案 #

配合上述方法，可进一步降低Git服务器压力：

• 启用浅克隆：在Jenkins的SCM配置中勾选Shallow clone，或在git命令中添加--depth 1参数，减少拉取的仓库体积；
• 设置本地仓库缓存：在执行器上预先克隆一份仓库，拉取时使用git clone --reference 本地缓存路径，仅同步增量内容。

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