Jenkins配置GitLab仓库SSH拉取代码失败问题排查

从你的错误日志和环境信息来看，核心问题出在SSH密钥格式错误以及Jenkins运行用户的权限配置上，下面一步步帮你排查修复：

1. 修复SSH密钥格式问题 #

错误日志里的Load key "...": invalid format是关键提示——你在Jenkins里配置的私钥格式不对。请检查：

• 确保你粘贴的私钥是完整的，包括开头的-----BEGIN OPENSSH PRIVATE KEY-----和结尾的-----END OPENSSH PRIVATE KEY-----，并且每一行都完整，没有多余的空格或换行。
• 如果你的密钥是旧格式（比如-----BEGIN RSA PRIVATE KEY-----），可以用ssh-keygen -p -f /path/to/your/private/key命令转换为OpenSSH格式，再重新复制到Jenkins中。

2. 确认Jenkins运行用户的权限 #

Jenkins默认是以jenkins用户运行的，你提供的root用户.ssh目录权限和Jenkins的运行无关。需要确保：

• 把对应的公钥添加到GitLab项目的部署密钥中（或者GitLab用户的SSH密钥列表里），公钥是私钥对应的.pub文件内容。
• 如果你想让Jenkins直接使用服务器上的密钥，需要把密钥文件放到/var/lib/jenkins/.ssh/目录下，并且设置正确的权限：

  sudo cp /path/to/your/private/key /var/lib/jenkins/.ssh/id_rsa
  sudo chown jenkins:jenkins /var/lib/jenkins/.ssh/id_rsa
  sudo chmod 600 /var/lib/jenkins/.ssh/id_rsa
  sudo chmod 700 /var/lib/jenkins/.ssh/
  

  之后在Jenkins的源代码管理中，可以选择"使用本地密钥"，而不是手动粘贴私钥，这样能避免格式问题。

3. 测试Jenkins用户的SSH连接 #

在服务器上切换到jenkins用户，测试能否连接GitLab，确认权限和密钥是否正常：

sudo su - jenkins
ssh -T git@10.777.77.777

如果返回Welcome to GitLab, @root!之类的提示，说明连接正常；如果还是报错，根据提示进一步排查（比如密钥未添加到GitLab，或者权限不对）。

4. 检查GitLab项目的访问权限 #

确保你在GitLab中添加的公钥对应的用户（或部署密钥）拥有该项目的读取权限：

• 如果用的是部署密钥，要在项目的Settings > Repository > Deploy keys中添加，并且勾选"Allow write access"（如果需要推送的话，拉取只需要读取权限）。
• 如果用的是GitLab用户的SSH密钥，要确保该用户是项目的成员，并且角色至少是"Reporter"（拥有读取权限）。

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