如何解决Docker内Jenkins无法拉取Meson Git子项目仓库的问题

先按顺序定位根因，别上来就乱改配置：

• 先在meson setup执行前加两行调试命令，先确认容器网络状态：

  sh "curl -v --connect-timeout 10 https://github.com"
  sh "git ls-remote https://github.com/你的顶层项目仓库地址.git"
  

  要是curl都连不上，就是纯网络问题，和Meson、Git配置没关系；要是curl能通Git连不上，再查Git配置、凭据问题。
• 快速验证网络连通性的最快手段：临时给Docker agent加--network=host参数，让容器直接共享Jenkins agent宿主机的网络栈，如果改完就能拉通，说明问题出在Docker默认桥接网络的DNS、路由或者防火墙规则上。
• 检查子项目仓库权限：如果子仓库是私有仓库，容器内没有配置对应Git凭据的话，Meson拉取时也会报Git执行失败，不会单独提示权限不足。
• 检查代理配置：如果你的环境访问GitHub必须走正向代理，容器默认不会继承宿主机的代理环境变量，Git读不到代理配置自然连不上。

按排查出来的原因对应改就行：

桥接网络DNS不通 #

如果宿主机能正常访问GitHub，只有桥接模式下的容器解析不了域名，直接给容器指定可用的公网DNS或者公司内部DNS即可，配置示例：

agent {
    dockerfile {
        label "ag2"
        args '--dns 你环境里能正常解析GitHub的DNS地址'
    }
}

需要走代理访问外网 #

两步配置缺一不可：

1. 启动容器时把代理环境变量传进去：

   agent {
       dockerfile {
           label "ag2"
           args '--env HTTP_PROXY=http://代理地址:端口 --env HTTPS_PROXY=http://代理地址:端口 --env NO_PROXY=localhost,127.0.0.1'
       }
   }
   

2. 在执行构建命令前给Git配置全局代理，让Git走代理访问GitHub：

   steps {
       sh 'git config --global http.proxy $HTTP_PROXY'
       sh 'git config --global https.proxy $HTTPS_PROXY'
       sh "meson setup builddir"
       sh "meson compile -C builddir"
   }
   

   代理需要认证的话直接把账号密码拼到代理地址里，格式为http://用户名:密码@代理地址:端口

私有仓库拉取权限不足 #

用Jenkins的凭据绑定功能传递访问权限，不要硬编码凭据到代码里：

1. 提前在Jenkins凭据库存好有所有子仓库读权限的SSH私钥，或者GitHub PAT
2. 流水线里绑定凭据，同时配置Git自动替换拉取协议：

   steps {
       sshagent(['你存的SSH凭据ID']) {
           sh 'git config --global url."git@github.com:".insteadOf "https://github.com/"'
           sh "meson setup builddir"
           sh "meson compile -C builddir"
       }
   }
   

生产环境优化方案 #

不要每次构建都临时从公网拉子项目，网络波动很容易导致构建随机失败：

• 提前在Jenkins agent宿主机上缓存所有子项目源码，启动容器时把缓存目录挂载到项目的subprojects目录下，构建时给Meson加--wrap-mode=nodownload参数，让Meson优先读本地缓存的源码，完全不依赖公网连接。
• 挂载配置示例：

  agent {
      dockerfile {
          label "ag2"
          args '-v /本地缓存的子项目目录:/workspace/你的项目名/subprojects:ro'
      }
  }
  

  构建命令改成sh "meson setup builddir --wrap-mode=nodownload"即可。

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