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临时路径
- 对应该故障runner的配置段,添加
- 绕开临时CA文件的路径依赖,使用固定持久化证书路径:
- 将GitLab服务端的可信CA证书导出到固定持久路径,例如
/etc/gitlab-runner/certs/gitlab-ca.crt - 在该runner的配置段的
environment列表中添加固定环境变量:GIT_SSL_CAINFO=/etc/gitlab-runner/certs/gitlab-ca.crt - 为证书文件设置正确权限:属主为gitlab-runner运行用户,权限设置为
644,确保git客户端可正常读取
调整完成后,git拉取代码时将直接使用固定路径的CA证书完成校验,完全不依赖每次任务临时生成的CA文件,从根源上规避临时目录误删导致的报错。
- 将GitLab服务端的可信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
相关产品推荐
相关产品推荐

