基于docker:latest构建预缓存Gradle依赖的Docker镜像优化GitLab CI

嘿，这个问题我太熟了！GitLab.com的docker-auto-scale共享Runner确实坑，自带的缓存完全没法持久化，每次跑CI都要重新拉一堆Gradle依赖，慢得让人抓狂。你的思路完全靠谱——基于docker:latest做个预存依赖的自定义镜像，下面我给你一步步拆解怎么做：

一、构建带预缓存的自定义Docker镜像 #

首先得做个包含Gradle依赖的镜像，基于docker:latest（满足你需要和Docker守护进程交互的需求），同时要装JDK和Gradle，还要提前把项目依赖下载好缓存进去。

1. 编写Dockerfile #

创建一个Dockerfile文件，内容如下（根据你的项目Java版本调整JDK版本，比如用11或17）：

# 基于官方docker镜像，保证能和Docker守护进程交互
FROM docker:latest

# 安装OpenJDK和Gradle（Alpine系统用apk安装，按需调整版本）
RUN apk add --no-cache openjdk17 gradle

# 设置工作目录
WORKDIR /app

# 只复制依赖配置文件！这步很关键，避免代码变动导致镜像缓存失效
COPY build.gradle settings.gradle ./
COPY gradle ./gradle

# 执行依赖下载命令，把所有依赖缓存到镜像里
RUN gradle dependencies --no-daemon

2. 构建并推送镜像到GitLab容器仓库 #

把这个镜像推送到GitLab自己的容器仓库，这样CI就能直接拉取，不用折腾外部仓库：

# 构建镜像，替换成你的GitLab项目路径和镜像名
docker build -t registry.gitlab.com/你的用户名/你的项目名/gradle-docker-cache:latest .

# 登录GitLab容器仓库（输入你的GitLab个人访问令牌）
docker login registry.gitlab.com

# 推送镜像到仓库
docker push registry.gitlab.com/你的用户名/你的项目名/gradle-docker-cache:latest

二、修改.gitlab-ci.yml使用自定义镜像 #

接下来调整你的CI配置，用上刚才的镜像，同时可以配合GitLab的临时缓存补漏：

stages:
  - build

build:
  stage: build
  # 使用我们预存了依赖的自定义镜像
  image: registry.gitlab.com/你的用户名/你的项目名/gradle-docker-cache:latest
  script:
    # 执行构建命令，此时大部分依赖已经在镜像里，只需处理新增/更新的依赖
    - gradle build --no-daemon
  # 可选：用GitLab的临时缓存保存Gradle wrapper和少量新增依赖
  cache:
    paths:
      - .gradle/wrapper/
      - .gradle/caches/
    key: "$CI_COMMIT_REF_SLUG"

三、几个优化小细节 #

• 只复制依赖配置文件：千万别把整个项目代码复制到Dockerfile里，只有当build.gradle或settings.gradle变动时，才重新构建镜像，这样镜像能重复利用很久。
• 多模块项目适配：如果是多模块项目，记得把所有子模块的build.gradle也复制到Dockerfile里，比如COPY module1/build.gradle module1/。
• 定期更新镜像：当你升级依赖版本或者新增依赖时，记得重新构建并推送新的镜像版本，不然CI还是会下载新依赖。

这样调整后，每次CI运行时，90%以上的依赖已经在镜像里了，不用再从头下载，构建时间能砍大半！

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