GitLab CI中Docker启动Nginx出现挂载错误求助

问题场景 #

在GitLab CI（采用docker:dind执行器，GitLab Runner运行于Docker环境）执行部署任务时，启动Nginx容器出现报错，但本地环境运行一切正常。

错误信息 #

Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: error mounting "/builds/daniskazan/goboards-backend/nginx/nginx.conf" to rootfs at "/etc/nginx/nginx.conf": create mount destination for /etc/nginx/nginx.conf mount: cannot mkdir in /var/lib/docker/overlay2/cbcfa805f4e22d4b77cee331b5aee81ff2c8bb240fdd266cdce1d4c8bdc9642a/merged/etc/nginx/nginx.conf: not a directory: unknown: Are you trying to mount a directory onto a file (or vice-versa)? Check if the specified host path exists and is the expected type

当前docker-compose.yaml配置 #

services:
  nginx:
    image: nginx:1.25
    volumes:
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf
      - ./nginx/log:/var/log/nginx
    container_name: nginx-${ENVIRONMENT:-local}
    ports:
      - "80:80"

问题原因与解决办法 #

• 核心问题：要么是GitLab CI的dind环境中，Nginx镜像默认的/etc/nginx/nginx.conf是目录而非文件，导致宿主机的文件无法挂载到容器内的目录路径上；要么是CI构建目录里的./nginx/nginx.conf不存在，或者被识别成了目录。

解决办法1：挂载整个Nginx配置目录 #

把单独挂载nginx.conf改成挂载整个配置目录，确保容器能读取完整的配置结构。修改docker-compose的volumes部分：

volumes:
  - ./nginx:/etc/nginx
  - ./nginx/log:/var/log/nginx

注意要保证本地./nginx目录下有完整的Nginx配置文件（比如nginx.conf、conf.d子目录等），容器启动时才能正常加载配置。

解决办法2：提前生成容器内的目标文件 #

在CI脚本里先临时启动Nginx容器，把默认的nginx.conf复制到挂载目录，再启动正式容器：

# CI步骤中添加以下命令
mkdir -p ./nginx
docker run --rm nginx:1.25 cat /etc/nginx/nginx.conf > ./nginx/nginx.conf
# 之后再执行docker-compose up -d

解决办法3：检查CI环境的路径与文件状态 #

在CI脚本里添加检查步骤，确认构建目录中的./nginx/nginx.conf确实是文件且存在：

ls -la ./nginx/
file ./nginx/nginx.conf

如果文件不存在，要确保代码仓库里包含该文件，或者在CI过程中生成它。

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