You need to enable JavaScript to run this app. gitlab-runner 执行CI任务时git clone随机报SSL CA证书错误,排查CI_SERVER_TLS_CA_FILE缺失问题
优惠活动
大模型
产品
解决方案
定价
更多

gitlab-runner 执行CI任务时git clone随机报SSL CA证书错误,排查CI_SERVER_TLS_CA_FILE缺失问题

GitLab Runner 13.7.0 随机SSL CA证书报错根因与修复方案

核心根因定位

  • GitLab Runner 13.x 版本的shell执行器,默认在每次CI任务启动时,自动将GitLab服务端的可信CA证书写入构建目录下的临时路径,也就是你观测到的/var/gitlab-runner/builds/<gitlab-runner-id>/0/<gitlab-group>/<gitlab-project>/.tmp/CI_SERVER_TLS_CA_FILE,同时注入GIT_SSL_CAINFO环境变量,强制git客户端拉取HTTPS仓库时使用该临时证书完成SSL校验。
  • 你遇到的文件随机缺失问题,是13.7.0版本shell执行器的已知时序竞态bug:当任务切换、目录清理逻辑和CA文件写入流程出现时序差时,系统会在新任务的CA文件尚未写入前,提前递归删除.tmp临时目录;后续流程检测到目录已“存在残留”时会跳过目录重建步骤,最终导致CA文件写入失败、文件缺失,触发Problem with the SSL CA cert (path? access rights?)报错。
  • 你观测到的所有现象都可以被该bug解释:
    • 重新注册runner时会重建对应构建目录,临时目录为全新状态,清理逻辑的竞态不会触发,因此首次任务运行正常
    • 其他同配置服务器无该问题,是因为服务器的任务并发触发频率、磁盘IO时延刚好没达到竞态触发的阈值,并非配置差异
    • 手动拷贝正常CA文件后出现单次令牌鉴权失败,是因为工作目录残留了上一次任务的过期CI_JOB_TOKEN,git自动复用旧令牌导致鉴权失败,与证书文件本身无关,也侧面印证CA文件缺失是SSL报错的触发源。

落地修复步骤

临时止血方案(不替换现有Runner二进制版本)

  • 调整runner全局配置(默认路径/etc/gitlab-runner/config.toml),关闭触发竞态的强制目录清理逻辑:
    • 对应该故障runner的配置段,添加force_clean_builds = false参数,禁止任务启动时强制递归清空整个构建目录
    • 在配置段添加clean_builds_dir = false,关闭后台自动清理过期构建目录的逻辑,避免系统跨项目删除.tmp临时路径
  • 绕开临时CA文件的路径依赖,使用固定持久化证书路径:
    1. 将GitLab服务端的可信CA证书导出到固定持久路径,例如/etc/gitlab-runner/certs/gitlab-ca.crt
    2. 在该runner的配置段的environment列表中添加固定环境变量:GIT_SSL_CAINFO=/etc/gitlab-runner/certs/gitlab-ca.crt
    3. 为证书文件设置正确权限:属主为gitlab-runner运行用户,权限设置为644,确保git客户端可正常读取
      调整完成后,git拉取代码时将直接使用固定路径的CA证书完成校验,完全不依赖每次任务临时生成的CA文件,从根源上规避临时目录误删导致的报错。

永久修复方案

  • 13.7.0版本的目录清理与CA写入竞态bug,在13.7.2之后的同大版本小更新中已通过流程加锁完成修复。可直接将gitlab-runner二进制替换为13.12.x同大版本的稳定版,该版本与13.7.0的配置完全兼容,不会破坏现有CI流程,修复后不会再出现临时CA文件莫名缺失的问题。

效果验证

  • 修改配置后手动连续触发10次以上CI任务,检查Cloning repository...步骤无SSL CA证书报错
  • 检查对应构建目录下的.tmp路径不会在任务执行过程中被提前删除

内容的提问来源于stack exchange,提问作者bmakan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 18:36:00