GitLab DinD环境构建镜像报`Please provide a source image with from prior to commit`错误如何解决

核心原因说明 #

你遇到的报错本质是GitLab CI 13.7.4的DinD环境默认构建逻辑与本地Docker存在配置差异，旧版非BuildKit构建器无法正确识别首个FROM指令之前声明的全局ARG，导致构建流程误判Dockerfile不存在合法的基础镜像源声明。

排查步骤 #

• 第一步：验证CI环境的构建配置，在.gitlab-ci.yml的构建步骤前添加日志输出命令，确认DOCKER_BUILDKIT环境变量的取值，同时排查Docker客户端、服务端版本是否匹配：

  echo $DOCKER_BUILDKIT
  docker version
  docker info
  

• 第二步：使用最小化Dockerfile复现验证，编写仅包含全局ARG+FROM的测试Dockerfile，排除原Dockerfile其他语法错误的干扰：

  ARG TEST_BASE=alpine:latest
  FROM ${TEST_BASE}
  

  在CI中单独构建该测试文件，确认问题是否复现。

解决方法 #

方法1：显式启用BuildKit（推荐） #

在.gitlab-ci.yml的全局变量或构建步骤变量中添加配置，强制启用BuildKit构建器，该构建器对全局ARG的兼容性更优，完全匹配本地Docker 20.10.7的行为：

variables:
  DOCKER_BUILDKIT: 1

配置后重新执行构建即可正常识别首个FROM前的ARG参数。

方法2：调整Dockerfile语法兼容旧构建器 #

如果暂时无法开启BuildKit，可以调整ARG的声明位置：

• 如果ARG仅用于后续构建阶段，将ARG声明移至对应FROM指令之后即可
• 如果ARG用于动态指定基础镜像，可直接在CI构建命令中通过--build-arg传入的同时，将基础镜像值硬编码为兜底默认值，避免使用全局ARG：

  docker build --build-arg BASE_IMAGE=your-custom-image:v1 .
  

方法3：升级GitLab Runner版本 #

GitLab Runner 13.7.x版本存在多处DinD默认配置兼容性问题，升级到14.x及以上版本后，DinD的默认构建逻辑已和标准Docker对齐，也可解决该问题。

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