Windows环境Jenkins集成GitLab拉取Jenkinsfile执行Pipeline克隆报错排查

结合运行日志、已完成操作和「Windows主节点+Linux执行从节点」的架构特征，所有已执行的配置均仅在Windows本地生效，与Linux从节点的Pipeline执行环境完全脱节，具体遗漏配置如下：

全局Git工具配置匹配错误 #

日志中Selected Git installation does not exist. Using Default、The recommended git tool is: NONE的提示，直接说明Git工具配置的作用域错位：

• 你之前在Jenkins中配置的Git路径，大概率是Windows本地的Git可执行路径（如C:\Program Files\Git\bin\git.exe），但Pipeline实际执行checkout操作的节点是Linux从节点，该路径在Linux环境下完全不存在，自然无法识别；
• 没有给Linux从节点单独映射对应环境的Git可执行路径（Linux系统默认Git安装路径为/usr/bin/git），导致Jenkins无法根据Pipeline的运行节点自动匹配可用Git工具。

Git全局配置作用域不对 #

你之前执行的关闭SSL校验操作是在Windows端Git Bash中完成的，该配置仅会写入Windows当前操作用户的~/.gitconfig文件，对Linux从节点上运行的Git进程无任何影响：

• 从报错路径/root/jenkins/workspace/CICD_2104可判断，Linux从节点上运行Pipeline的身份是root用户，该用户的Git配置文件为/root/.gitconfig，当前该文件中既未关闭SSL校验，也没有对应的SSH信任配置。

SSH凭据的跨节点生效问题 #

虽然你在Windows端Git Bash中生成了SSH密钥并同步公钥到GitLab，但存在两个配置断点：

• 若没有将对应SSH私钥作为凭据上传到Jenkins全局凭据库（也就是日志中id为c36c23b2-ea6e-4bc6-afff-dfbe559198e4的凭据），仅把私钥存在Windows本地的.ssh目录下，Linux从节点的Git进程根本无法获取私钥完成SSH认证；
• 需确认上传到Jenkins的SSH凭据，对Linux从节点的执行用户是可见可用的，没有被权限限制拦截。

Linux从节点基础环境缺失 #

• 需确认Linux从节点本身已安装Git基础软件，而非仅部署了Jenkins Agent程序；
• 需确认运行Jenkins Agent的root用户，对工作目录/root/jenkins/workspace/拥有完整的读写、创建权限，否则Git执行init初始化仓库操作时会直接被系统拦截，触发Could not init的报错。

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