GitLab CI/CD构建Java Spring镜像后上传DockerHub遇问题求助

针对你的场景，有两种最优解决方案，都是围绕让CI环境具备Docker客户端能力来实现：

方案一：在现有Maven镜像中临时安装Docker客户端 #

你已经配置了docker:dind服务（提供Docker守护进程），只需在构建脚本开头安装Docker客户端即可解决"找不到docker"的报错。修改后的完整CI配置如下：

java-build:
  tags:
    - docker-in-docker
  image: maven:3.8-openjdk-11
  services:
    - docker:20.10.13-dind-alpine3.15
  variables:
    DOCKER_HOST: tcp://docker:2375  # 指定连接dind服务的守护进程地址
    DOCKER_TLS_CERTDIR: ""  # 禁用TLS验证，适配dind的无证书模式
  stage: build
  script:
    # 安装Docker客户端（maven镜像基于Debian，用apt包管理器）
    - apt-get update && apt-get install -y docker.io
    # 构建Spring项目Jar包
    - mvn clean package
    # 构建Docker镜像（假设项目根目录存在Dockerfile）
    - docker build -t $DOCKER_IMAGE:latest .
    # 登录DockerHub并推送镜像
    - echo "$DOCKER_REGISTRY_PASSWORD" | docker login -u $DOCKER_REGISTRY_USER --password-stdin
    - docker push $DOCKER_IMAGE:latest

关键说明 #

• DOCKER_HOST：让Docker客户端知道要连接到dind服务提供的守护进程，而不是本地的Docker
• DOCKER_TLS_CERTDIR：默认dind服务启用TLS，但临时安装的客户端没有证书，所以禁用TLS避免报错（生产环境建议配置TLS证书）

方案二：使用预集成Maven和Docker客户端的自定义镜像 #

如果不想每次构建都重复安装Docker客户端，可以提前构建一个包含Maven和Docker客户端的镜像，后续CI直接复用。

第一步：构建自定义镜像 #

创建一个Dockerfile：

FROM maven:3.8-openjdk-11
RUN apt-get update && apt-get install -y docker.io && rm -rf /var/lib/apt/lists/*

将这个镜像推送到你的私有镜像仓库（比如DockerHub或GitLab镜像仓库）。

第二步：修改CI配置 #

替换image字段为你的自定义镜像：

java-build:
  tags:
    - docker-in-docker
  image: your-repo/maven-with-docker:3.8-openjdk-11
  services:
    - docker:20.10.13-dind-alpine3.15
  variables:
    DOCKER_HOST: tcp://docker:2375
    DOCKER_TLS_CERTDIR: ""
  stage: build
  script:
    - mvn clean package
    - docker build -t $DOCKER_IMAGE:latest .
    - echo "$DOCKER_REGISTRY_PASSWORD" | docker login -u $DOCKER_REGISTRY_USER --password-stdin
    - docker push $DOCKER_IMAGE:latest

这种方案的优势是减少每次构建的耗时，适合频繁触发的CI流水线。

注意事项 #

• 确保GitLab项目的CI/CD变量中已正确配置DOCKER_REGISTRY_USER、DOCKER_REGISTRY_PASSWORD、DOCKER_IMAGE三个变量
• 检查项目根目录的Dockerfile是否正确复制了target目录下的Spring Jar包

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