GitLab CI 缓存 key 写错 每次重装依赖多花 220 秒

流水线里 install 这一步稳定 3 分 40 秒,缓存从来没命中过。日志里一行 WARNING: file does not exist,接着就是 npm ci 全量下载。

cache 段是这么写的:key 用了 $CI_COMMIT_SHA。每次提交哈希都变,等于每次新建一份缓存,旧的一直占着空间。

改成 $CI_COMMIT_REF_SLUG 之后命中了一部分,换分支还是重装。十几个人各自推分支,缓存散成二十多份,谁也不沾谁的光。

真正的问题在 cache:key:files。依赖版本由 package-lock.json 决定,key 应该跟着锁文件走,而不是跟着提交走。内容不变就复用同一份。

cache:
  key:
    files:
      - package-lock.json
  paths:
    - node_modules/
    - .npm/

只改 key 还不够。npm ci 默认先删掉 node_modules 再装,缓存下来等于白存。换成 npm ci --prefer-offline,配合 .npm 目录,命中时只做链接。

runner 是 docker executor,缓存目录默认在容器内,容器一销毁就没了。要在 config.toml 挂 volume,把 /cache 落到宿主机,否则日志里永远是 Storing cache 成功、下次取不到。

[runners.docker]
  volumes = ["/data/gitlab-cache:/cache"]

runner 的缓存还是分机的。两台机器没共享目录,命中率只有一半。要么挂 NFS,要么用 S3 做分布式缓存,别指望本地磁盘。

确认:连跑三次同一提交,第二次开始 install 从 220 秒降到 18 秒;流水线页面出现 Cache 命中提示;再切一个新分支,第一次冷启动,第二次仍然命中。

顺手把 node_modules 从 artifacts 里去掉。之前每份产物 400MB,上传下载比安装还慢,纯属反着来。

您可以还会对下面的文章感兴趣: