GitLab Pipeline Docker任务无法访问gitlab-runner宿主机compose文件

你当前使用的是Docker类型执行器的GitLab Runner，CI任务的所有执行逻辑都运行在独立的隔离容器中，容器默认和Runner所在宿主机的文件系统完全隔离。你在脚本中写的相对路径compose_testfile.yaml，会默认从CI拉取代码后的工作目录/builds/testaccount/testproject/下查找，这个目录是Job容器内的仓库目录，自然找不到存在宿主机上的文件，因此触发文件不存在报错。
另外你配置的docker:dind服务本身也是独立运行的服务容器，和Job执行容器、宿主机三者文件系统默认互不可见，不会自动打通宿主机文件路径。

方法1：配置Runner挂载宿主机目录（最适配你的场景） #

这个方法需要修改Runner的宿主机配置，把存放compose文件的目录挂载到CI Job容器内部：

1. 登录GitLab Runner所在的宿主机，打开Runner配置文件，默认路径为/etc/gitlab-runner/config.toml
2. 找到对应执行任务的Runner配置段，定位到[runners.docker]配置块，在volumes配置项中添加宿主机目录到容器的挂载规则。
   举个例子，假设你的compose_testfile.yaml在宿主机上的存放路径是/data/ci/conf/compose_testfile.yaml，就添加如下挂载配置：

   volumes = ["/cache", "/data/ci/conf:/ci/host-conf:ro"]
   

   配置说明：
   • 冒号前是宿主机真实路径，冒号后是容器内的访问路径
   • 末尾的:ro代表只读挂载，避免CI任务误修改宿主机文件，降低安全风险
3. 保存配置后执行systemctl restart gitlab-runner重启Runner服务让配置生效
4. 修改.gitlab-ci.yml中的脚本，使用容器内的挂载路径访问compose文件即可：

   script:
     - docker-compose -f /ci/host-conf/compose_testfile.yaml down
   

方法2：将compose文件存为项目CI文件变量（无需修改Runner配置） #

如果你没有权限修改Runner的全局配置，可以用GitLab CI自带的文件类型变量实现，不需要依赖宿主机文件：

1. 打开项目的设置 > CI/CD > 变量页面，新建变量
2. 变量名自定义，比如COMPOSE_TEST_FILE，变量类型选择文件(File)，变量值填入宿主机上compose_testfile.yaml的全量内容，可根据需要勾选保护变量、掩码变量选项
3. 保存变量后，CI任务运行时GitLab会自动把变量内容写入一个临时文件，变量值就是这个临时文件的绝对路径，直接在脚本中引用即可：

   script:
     - docker-compose -f $COMPOSE_TEST_FILE down
   

• 禁止将宿主机根目录、/root、/etc等敏感系统目录挂载到CI容器，会造成严重的安全隐患，仅挂载业务需要的最小范围目录即可
• 如果你的CI任务需要让docker:dind服务也能访问到这个compose文件，需要在挂载配置中同时把目录挂到dind服务容器内，配置方式是在[runners.docker]段的services配置中给docker:dind加挂载规则即可。

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