如何在同主机容器化Jenkins中配置CentOS本地Git仓库路径

这个问题我碰到过好几次，其实核心就是解决容器的文件隔离和权限问题，一步步来就搞定了：

1. 调整本地Git仓库的权限 #

容器里的Jenkins进程默认是以jenkins用户运行的（UID通常是1000），所以首先要确保这个用户能读取你的本地Git仓库。你可以先检查容器内jenkins用户的UID：

docker exec <你的Jenkins容器名> id jenkins

然后修改本地仓库的所有者和权限，让容器内的jenkins用户能访问：

# 替换成你的本地仓库路径和上面查到的UID/GID
chown -R 1000:1000 /path/to/your/local/git/repo
chmod -R 755 /path/to/your/local/git/repo

2. 将本地仓库挂载到Jenkins容器 #

因为容器是独立的文件系统，你需要把本地Git仓库目录挂载到容器内部的某个路径。如果是用docker run启动的Jenkins，启动时添加挂载参数：

docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  # 挂载本地仓库到容器内的/var/jenkins_home/local-git-repo路径，ro表示只读（更安全）
  -v /path/to/your/local/git/repo:/var/jenkins_home/local-git-repo:ro \
  jenkins/jenkins:lts

如果用Docker Compose，在docker-compose.yml里添加：

services:
  jenkins:
    image: jenkins/jenkins:lts
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - ./jenkins_home:/var/jenkins_home
      # 挂载本地Git仓库
      - /path/to/your/local/git/repo:/var/jenkins_home/local-git-repo:ro

3. 在Jenkins任务中配置Git路径 #

创建或编辑Jenkins任务时，找到源码管理部分，选择Git，然后在Repository URL里填写容器内的挂载路径，注意要用file:///协议（三个斜杠）：

file:///var/jenkins_home/local-git-repo

如果是Pipeline任务，可以这样写：

pipeline {
  agent any
  stages {
    stage('Checkout') {
      steps {
        git url: 'file:///var/jenkins_home/local-git-repo', branch: 'main'
      }
    }
  }
}

4. 常见问题排查 #

• 如果Jenkins提示“Permission denied”，再检查本地仓库的权限是否正确，或者挂载路径是否写错。
• 如果容器里没有Git，官方Jenkins镜像默认已经安装了Git，如果你的镜像没有，需要进入容器安装：docker exec -it jenkins yum install git -y（CentOS基础镜像的话）或者apt-get install git -y（Debian基础）。
• 确保挂载的路径在容器内存在，你可以进入容器验证：docker exec -it jenkins ls /var/jenkins_home/local-git-repo

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