Docker部署的Jenkins多流水线任务无法连接GitHub仓库问题咨询

报错信息 #

Failed to connect to repository : Error performing git command: ls-remote -h https://github.com/hichemmehdi/EmployeeManager.git HEAD

排查&解决步骤 #

• 第一步：验证容器内部网络连通性
  首先获取Jenkins容器ID：docker ps | grep jenkins
  进入容器内部执行测试命令：

  docker exec -u root -it <替换为你的Jenkins容器ID> bash
  # 容器内执行Git连通性测试
  git ls-remote -h https://github.com/hichemmehdi/EmployeeManager.git HEAD
  

  如果执行报错，按对应场景处理：
  • 提示git命令不存在：官方jenkins/jenkins:lts-jdk11镜像默认不带Git组件，执行apt update && apt install -y git完成安装后重新测试即可。
  • 提示连接超时/无法解析域名：优先检查容器DNS配置，可在运行容器时添加DNS参数--dns 8.8.8.8 --dns 114.114.114.114；如果宿主机需要代理才能访问GitHub，运行容器时添加代理环境变量：

    sudo docker run -p 8181:8080 -p 50000:50000 \
    -e HTTP_PROXY=http://你的代理地址:端口 \
    -e HTTPS_PROXY=http://你的代理地址:端口 \
    -v /home/ubuntu/jenkins:/var/jenkins_home \
    jenkins/jenkins:lts-jdk11
    

  • 提示SSL证书验证失败：可先临时执行git config --global http.sslVerify false测试连通性，测试通过后建议更新容器内CA证书包解决，正式环境不要长期关闭SSL验证。
• 第二步：验证Jenkins凭证配置正确性
  GitHub已禁止使用账号密码进行Git操作，Jenkins中配置凭证时需注意：
  • 凭证类型选择「用户名与密码」，用户名填GitHub账号名，密码栏填写GitHub个人访问令牌（PAT），不要填写账号登录密码。
  • 凭证作用域选择全局，或者对应流水线任务的所属作用域，确保任务有权限调用该凭证。
• 第三步：检查Jenkins Git插件版本
  进入Jenkins「插件管理」页面，检查Git插件是否为最新版，旧版本插件可能和GitHub最新认证规则不兼容，升级后重启Jenkins再测试即可。

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