GitLab CI执行单元测试时如何访问Runner主机本地文件？

问题原因 #

GitLab CI的test阶段运行在独立的容器镜像中，容器默认与主机文件系统隔离，因此无法直接访问Runner主机上的/path/to/jpg路径。

解决方案 #

需要通过GitLab Runner的卷挂载配置，将主机目录映射到测试容器内部，具体步骤如下：

1. 修改GitLab Runner配置文件 #

找到Runner的config.toml配置文件（默认路径为/etc/gitlab-runner/config.toml），在对应Runner的[[runners]]块中添加卷挂载规则：

[[runners]]
  # 保留原有配置...
  [runners.docker]
    # 保留原有配置...
    volumes = ["/cache", "/path/to/jpg:/container/jpg:ro"]

• /path/to/jpg：Runner主机上存放图片的目录路径
• /container/jpg：测试容器内对应的映射路径
• ro：设置为只读权限，避免容器修改主机文件（可选但推荐）

修改完成后，重启GitLab Runner服务使配置生效：

sudo gitlab-runner restart

2. 调整单元测试或CI配置 #

确保单元测试中读取图片的路径指向容器内的映射路径（例如/container/jpg/xxx.jpg）。也可以在test job中通过环境变量统一指定路径：

test:
  image: $IMAGE_NAME:$CI_COMMIT_SHA
  stage: test
  variables:
    TEST_IMAGE_PATH: "/container/jpg/your-target-image.jpg"
  script:
    - pip install pytest
    - pytest

之后在单元测试代码中读取TEST_IMAGE_PATH环境变量即可。

3. 权限检查 #

确保GitLab Runner的运行用户（默认是gitlab-runner）对主机的/path/to/jpg目录及文件有读取权限，可通过以下命令调整：

# 给其他用户添加文件读取权限
chmod o+r /path/to/jpg/*.jpg
# 或者将gitlab-runner用户加入文件所属组
sudo usermod -aG your-file-group gitlab-runner

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