GitLab流水线Docker命令未找到问题排查与解决请求

原因分析 #

你的Dockerfile写法存在错误，导致最终构建出的镜像仅包含Gradle环境，没有Docker客户端：

• 多阶段构建中，最后一个FROM指令定义的阶段会成为最终镜像。你写了FROM gradle AS final-gradle作为最后一个阶段，所以最终镜像就是gradle:7.4-jdk17的内容，完全不包含Docker客户端的二进制文件，因此执行docker命令时会提示"command not found"。
• 你之前定义的docker阶段和final-docker阶段没有被用到，属于无效配置。

修正方案 #

方案1：基于Gradle镜像安装Docker客户端 #

直接在Gradle基础镜像上安装Docker CLI，适配gradle:7.4-jdk17默认的Alpine环境：

FROM gradle:7.4-jdk17 AS final

# 安装Docker客户端及依赖
RUN apk add --no-cache docker-cli

方案2：多阶段构建复制Docker客户端二进制 #

从官方docker镜像中复制已编译好的Docker客户端到Gradle镜像，避免额外安装依赖：

FROM docker:latest AS docker-client

FROM gradle:7.4-jdk17 AS final

# 复制Docker客户端二进制文件到Gradle镜像的可执行路径
COPY --from=docker-client /usr/local/bin/docker /usr/local/bin/docker

补充GitLab流水线配置优化 #

使用docker:dind服务时，需要添加环境变量确保Docker客户端能正确连接到Docker守护进程，在variables中补充：

variables:
  DOCKER_TLS_CERTDIR: "/certs"
  DOCKER_HOST: "tcp://docker:2376"
  DOCKER_TLS_VERIFY: "1"

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