GitLab CI环境Docker构建chmod路径访问失败问题解决

问题描述 #

本地通过docker-compose指定Dockerfile构建镜像完全正常，但GitLab CI环境中构建报错：

chmod: cannot access '/opt/firefox/firefox': Not a directory
构建命令返回非零退出码1。添加debug步骤后确认两个异常：

• /distr/firefox 是普通文件而非预期的目录
• /opt/firefox 目录不存在

相关代码片段 #

Dockerfile 关键部分 #

RUN mkdir -p /opt/firefox
COPY distr/firefox /opt/firefox/
RUN chmod +x /opt/firefox/firefox

.gitlab-ci.yml 构建阶段 #

build:
  stage: build
  image: docker:latest
  services:
    - docker:dind
  script:
    - docker-compose build
    # 新增的debug排查步骤
    - docker run --rm --entrypoint sh <临时镜像ID> -c "ls -la /distr && ls -la /opt"

Debug输出示例 #

/distr:
total 12
drwxr-xr-x 2 root root 4096 Aug 10 12:00 .
drwxr-xr-x 1 root root 4096 Aug 10 12:00 ..
-rw-r--r-- 1 root root  123 Aug 10 12:00 firefox

/opt:
total 8
drwxr-xr-x 1 root root 4096 Aug 10 12:00 .
drwxr-xr-x 1 root root 4096 Aug 10 12:00 ..

解决方案 #

1. 修复Git仓库中distr/firefox的类型 #

Git无法追踪空目录，若distr/firefox被误提交为普通文件或符号链接，会导致GitLab CI拉取代码后状态异常：

• 本地执行ls -ld distr/firefox确认是目录类型
• 若为符号链接：修改Dockerfile的COPY命令为COPY distr/firefox/ /opt/firefox/（末尾斜杠确保复制目录内内容）
• 若Git中误提交了同名文件：执行git rm --cached distr/firefox提交删除，再向目录中添加.gitkeep文件后重新提交，让Git追踪目录

2. 调整Dockerfile的COPY命令逻辑 #

Docker COPY命令的行为差异是核心诱因：

• COPY distr/firefox /opt/firefox/：仅当distr/firefox是目录时，才会将目录内容复制到/opt/firefox
• 修改为更严谨的写法，避免文件覆盖目录：

RUN mkdir -p /opt/firefox
# 明确复制目录内所有内容到目标目录
COPY distr/firefox/* /opt/firefox/
# 或者先验证源路径是目录再执行后续操作
RUN test -d /distr/firefox && chmod +x /opt/firefox/firefox

3. 清理GitLab CI构建缓存 #

旧缓存可能残留错误的文件状态，可在CI脚本中添加清理步骤：

before_script:
  - rm -rf distr/firefox || true
  - git checkout HEAD -- distr/firefox

也可直接在GitLab项目设置的「CI/CD」-「缓存」中手动清理全局缓存

4. 确认docker-compose构建上下文路径 #

检查docker-compose.yml中的build.context配置，确保上下文路径正确，避免因路径解析错误导致distr/firefox被错误识别。

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