Ubuntu本地Jenkins无法识别本地Git仓库的问题解决咨询

问题根源 #

你通过git init创建的是非裸Git仓库，仓库的核心数据目录是/home/my_user/projects/my_repo/.git，但你在Jenkins配置里填写的file:///home/my_user/projects/my_repo.git是在寻找一个名为my_repo.git的裸仓库，这个路径实际不存在，因此触发报错。

解决方案 #

方案一：直接使用非裸仓库的正确路径 #

Jenkins支持直接拉取非裸仓库，只需修改Git源路径：

• 将Jenkins配置中的Source/Git路径改为：

  file:///home/my_user/projects/my_repo
  

  或者直接使用本地绝对路径：

  /home/my_user/projects/my_repo
  

• 确保Jenkins运行用户（默认是jenkins用户）拥有仓库目录的读取权限：

  # 将jenkins用户加入你的用户组（替换my_user为你的实际用户名）
  sudo usermod -aG my_user jenkins
  # 调整仓库目录权限，允许组用户读取
  chmod -R g+r /home/my_user/projects/my_repo
  # 重启Jenkins使权限生效
  sudo systemctl restart jenkins
  

方案二：转为裸仓库（适合共享场景） #

如果需要将该仓库作为团队共享的远程仓库，可转为裸仓库：

1. 备份原仓库（可选但推荐）：

   cp -r /home/my_user/projects/my_repo /home/my_user/projects/my_repo_backup
   

2. 创建裸仓库：

   git clone --bare /home/my_user/projects/my_repo /home/my_user/projects/my_repo.git
   

3. 调整裸仓库权限，让Jenkins可访问：

   sudo chown -R jenkins:jenkins /home/my_user/projects/my_repo.git
   chmod -R 755 /home/my_user/projects/my_repo.git
   

4. 此时Jenkins配置中的file:///home/my_user/projects/my_repo.git路径即可正常使用。

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