GitLab CI第二阶段拉取gitlab-runner-helper镜像失败求助

1. 匹配GitLab Runner与Helper镜像版本 #

gitlab-runner-helper镜像版本必须和Runner本体版本完全一致，否则会出现拉取失败或兼容性问题：

• 先查看当前Runner版本：

  docker exec gitlab-runner gitlab-runner --version
  

• 手动拉取对应版本的helper镜像到主机（替换<版本号>为实际查到的版本，比如16.8.0）：

  docker pull gitlab/gitlab-runner-helper:<版本号>-x86_64
  

• 后续Runner会优先使用本地已存在的镜像，无需远程拉取。

2. 排查Runner容器的网络连通性 #

Runner容器可能无法访问GitLab镜像仓库，导致拉取失败：

• 进入Runner容器测试网络：

  docker exec -it gitlab-runner ping registry.gitlab.com
  

• 如果网络不通，在docker-compose.yml中为Runner添加DNS配置：

  services:
    gitlab-runner:
      image: gitlab/gitlab-runner:latest
      container_name: gitlab-runner 
      restart: always
      volumes:
        - /var/run/docker.sock:/var/run/docker.sock
        - /etc/gitlab-runner/config.toml:/etc/gitlab-runner/config.toml
      dns:
        - 8.8.8.8
        - 114.114.114.114
  

3. 优化CI配置，减少不必要的网络依赖 #

你的测试阶段重复克隆编译googletest，既耗时又增加网络风险，结合你第二阶段可访问构建产物的条件，调整如下：

• 修改build阶段缓存，提前编译googletest并加入缓存：

  build-code:
    stage: build
    tags:
      - docker
    script:
      - echo "Current working directory:"
      - pwd
      - cd cpp
      - mkdir -p build
      - cd build
      - cmake ..
      - make -j12
      # 提前编译googletest
      - cd ../..
      - git clone https://github.com/google/googletest/
      - cd googletest
      - mkdir build
      - cd build
      - cmake ..
      - make -j12
    cache:
      paths:
        - cpp/build
        - googletest/build
  

• 简化test阶段脚本，直接使用缓存的googletest，无需重复克隆编译：

  run-unittest:
    stage: test
    tags:
      - docker
    script:
      - cd googletest/build
      - sudo make install
      # 执行你的单元测试，比如运行cpp/build下的测试二进制文件
      - cd ../../cpp/build
      - ./your_test_executable
  

4. 检查Docker套接字的权限配置 #

虽然第一阶段正常，但第二阶段可能因权限问题导致镜像拉取失败：

• 检查主机上Docker套接字的权限：

  ls -l /var/run/docker.sock
  

• 如果权限为root:docker，在docker-compose.yml中让Runner以root用户运行：

  services:
    gitlab-runner:
      ...
      user: root
  

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