如何在GitLab中借助dind或dood缓存Docker镜像

在本地环境中Docker镜像可以缓存复用，但GitLab CI的dind容器在流水线结束后会被销毁，导致每次都要重新拉取镜像，既拖慢速度又容易触发Docker Hub的速率限制。以下是几个实用的解决办法：

1. 启用GitLab CI镜像缓存 #

利用GitLab CI的缓存机制，将Docker镜像存储路径加入缓存，后续流水线可直接复用已拉取的镜像。

在.gitlab-ci.yml中配置缓存：

build:
  stage: build
  image: docker:latest
  services:
    - docker:dind
  variables:
    DOCKER_DRIVER: overlay2
  cache:
    key: "docker-cache-${CI_COMMIT_BRANCH}"
    paths:
      - /var/lib/docker
    policy: pull-push
  script:
    - docker pull nginx:alpine
    - # 执行你的构建/测试命令

注意：该方式更适合专用Runner场景，共享Runner的缓存可能存在冲突；同时要留意GitLab对缓存大小的限制，避免缓存过大导致失效。

2. 改用GitLab容器注册表存储镜像 #

将常用的基础镜像或自定义镜像推送到GitLab自带的容器注册表，CI拉取时直接使用内部地址，既绕开Docker Hub的速率限制，又能获得更快的拉取速度（同区域网络）。

操作步骤：

• 本地将镜像重命名为GitLab注册表格式：registry.gitlab.com/[你的用户名/项目名]/[镜像名]:[标签]
• 登录GitLab注册表后推送镜像：docker push registry.gitlab.com/[你的用户名/项目名]/[镜像名]:[标签]
• 在CI脚本中直接拉取该镜像即可。

3. 配置Docker Hub认证凭证 #

Docker Hub对匿名用户的速率限制（每6小时100次拉取）远严格于认证用户（每6小时200次），配置登录凭证能有效降低触发限制的概率。

在GitLab项目的Settings > CI/CD > Variables中添加两个变量：

• DOCKER_USER：你的Docker Hub用户名
• DOCKER_PASSWORD：你的Docker Hub密码或访问令牌

然后在CI脚本中添加登录步骤：

docker login -u $DOCKER_USER -p $DOCKER_PASSWORD docker.io

4. 搭建内部镜像仓库 #

如果团队有多个项目需要复用镜像，可以搭建内部Docker镜像仓库（比如Harbor、官方Registry），将常用镜像同步到内部仓库，CI从内部仓库拉取镜像，彻底摆脱Docker Hub的限制，同时拉取速度更快。

使用时只需在拉取命令中指定内部仓库地址，例如：docker pull internal-registry:5000/nginx:alpine

5. 优化镜像使用策略 #

• 优先选择轻量镜像（如alpine版本），减少拉取时间和带宽消耗；
• 自定义基础镜像，将项目常用的依赖、工具打包进去，避免每次拉取多个零散镜像；
• 清理CI脚本中不必要的镜像拉取操作，只保留当前任务必需的镜像。

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