MacOS上Jenkins部分管道数月后需重新克隆仓库问题排查

• 隐性工作空间清理：即使排查了常规清理设置，仍可能存在遗漏的清理逻辑：
  • MacOS节点磁盘空间不足时，Jenkins的Disk Usage插件或系统级清理脚本可能自动删除长时间未使用的工作空间目录。
  • 部分流水线后续阶段可能通过deleteDir()或自定义Shell脚本误删了production目录，这类局部清理操作不在全局清理设置的排查范围内。
• Git仓库异常触发全量克隆：MacOS环境下的文件权限问题或Git操作异常，会导致GitSCM插件判定本地仓库无法修复，进而触发全量克隆：
  • 系统升级、权限变更导致Jenkins运行用户丢失仓库目录的读写权限。
  • Git操作超时、中断后，仓库处于索引损坏、refs文件缺失等不一致状态，插件直接放弃本地仓库。
• 节点环境干扰：异常管道所在的MacOS节点可能存在外部工具干扰：
  • Time Machine备份、第三方清理工具误操作删除了工作空间目录。
  • 节点临时目录配置错误，导致工作空间被当作临时文件清理。
• 插件版本bug：Git插件或流水线插件的旧版本存在MacOS特定环境下的工作空间处理bug，长时间运行后触发目录丢失。

• 检查清理机制：
  • 查看JenkinsDisk Usage插件的节点级配置，确认是否开启了基于空间阈值或使用时长的工作空间清理规则。
  • 检查MacOS节点的cron任务、第三方清理工具，确认是否有针对Jenkins工作空间目录的删除逻辑。
• 排查流水线脚本：
  • 完整检查异常流水线的所有阶段（包括共享库、外部引用脚本），确认是否存在deleteDir()、rm -rf production等可能删除仓库目录的代码。
• 定位仓库异常时机：
  • 在流水线的checkout阶段前添加调试步骤，记录目录状态：

    steps {
        sh 'ls -la production || echo "production directory not exists"'
        // 原有checkout代码
    }
    

  • 当问题再次出现时，立即登录对应MacOS节点，检查production目录是否存在、Git文件是否损坏，以及Jenkins运行用户的目录权限。
• 更新插件与工具：
  • 将Git插件、流水线插件更新至最新稳定版本，修复已知bug。
  • 升级MacOS节点上的Git客户端到最新版本，避免版本兼容性问题。
• 优化checkout配置：
  • 添加ResetBeforeCheckout扩展，在检查前重置仓库状态，减少全量克隆的触发：

    extensions: [
        [$class: 'CheckoutOption', timeout: 60],
        [$class: 'CloneOption', noTags: false, reference: '', shallow: false, timeout: 60],
        [$class: 'RelativeTargetDirectory', relativeTargetDir: 'production'],
        [$class: 'ResetBeforeCheckout'] // 新增配置
    ]
    

  • 配置本地引用仓库（reference参数），指定一个本地裸仓库作为缓存，即使触发全量克隆也能大幅提速。

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