GitLab Runner跨分支与多Runner缓存共享失效问题求助

针对你遇到的多Runner缓存无法共享和跨分支缓存无法复用问题，结合GitLab 13.3.5-ee版本特性，给出以下优化方案：

一、解决跨Runner缓存共享问题：配置集中式缓存存储 #

当前Runner使用本地/tmp/build-cache存储缓存，每个Runner的缓存相互独立。需要将所有Runner配置为使用集中式缓存存储（如S3兼容存储、GitLab内置对象存储），并开启缓存共享。

修改Runner配置文件（所有Runner的config.toml） #

以Nexus S3兼容存储为例，更新每个Runner的缓存配置部分：

[[runners]]
  # 保留原有name、url、token、executor等配置
  [runners.cache]
    Type = "s3"          # 指定缓存类型为S3
    Path = "gitlab-cache"# 缓存存储路径前缀
    Shared = true        # 开启多Runner共享缓存
    [runners.cache.s3]
      ServerAddress = "你的Nexus S3兼容端点" # 如：nexus.example.com:9000
      AccessKey = "$NEXUS_ACCESS_KEY"       # Nexus S3访问密钥
      SecretKey = "$NEXUS_SECRET_KEY"       # Nexus S3秘密密钥
      BucketName = "gitlab-runner-cache"    # 预先在Nexus创建的缓存桶名称
      Insecure = true                       # 若使用HTTP而非HTTPS则开启

注意：所有Runner必须配置相同的缓存存储参数，确保指向同一缓存源。如果使用GitLab内置对象存储，可替换为对应[runners.cache.gcs]或[runners.cache.azure]配置。

二、解决跨分支缓存复用问题：基于依赖锁文件生成缓存Key #

当前缓存Key使用固定的{$CI_JOB_NAME}，导致分支切换后即使依赖未变更也无法复用缓存。改为基于package-lock.json的内容哈希生成缓存Key，只要依赖锁文件不变，任何分支都能命中缓存。

修改.gitlab-ci.yml中install-dependency任务的缓存配置 #

install-dependency:
  stage: .pre
  script:
    - npm i --prefer-offline # install dependencies
  cache:
    key: 
      files:
        - package-lock.json  # 基于锁文件内容生成唯一缓存Key
      prefix: "node-modules" # 前缀区分不同类型缓存
    paths:
      - node_modules
    policy: pull-push
  artifacts:
    paths:
      - node_modules/

原理：GitLab会计算package-lock.json的SHA哈希值，与前缀组合成缓存Key。只要依赖未变更，哈希值不变，跨分支就能复用已有的缓存。

额外优化建议 #

1. 缓存与工件配合使用：保留artifacts传递node_modules给build任务，避免build任务重复拉取缓存，提升流水线效率。
2. 缓存清理策略：定期清理过期缓存，可通过GitLab CI变量或缓存存储的生命周期规则实现，避免缓存占用过多空间。
3. 权限验证：确保Nexus账号拥有缓存桶的读写权限，避免缓存推送/拉取失败。

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