GitLab CI/CD中Alpine APK缓存失败问题求助

问题分析 #

你遇到的缓存失败问题主要源于两点：

1. 未提前创建自定义缓存目录，apk命令不会自动生成目录，导致缓存文件无法写入
2. apk update未指定强制写入缓存的参数，索引文件不会保存到自定义目录中

修正后的.gitlab-ci.yml配置 #

stages:
- prepare
- build

.job_template: &job_config
  variables:
    APK_CACHE_DIR: $CI_PROJECT_DIR/.cache/apk
    APK_PACKAGES: bash
  cache:
    key: $CI_COMMIT_REF_SLUG
    paths:
      - $APK_CACHE_DIR
  image: alpine

prepare_alpine_cache:
  <<: *job_config
  stage: prepare
  script:
    # 提前创建缓存目录，确保apk可以写入
    - mkdir -p $APK_CACHE_DIR
    # 更新索引并强制写入缓存目录
    - apk update --cache-dir $APK_CACHE_DIR --update-cache
    # 安装包并将下载的包存入缓存
    - apk add --cache-dir $APK_CACHE_DIR $APK_PACKAGES

do_stuff1:
  <<: *job_config
  stage: build
  before_script:
    # 确保缓存目录存在
    - mkdir -p $APK_CACHE_DIR
    # 从缓存目录读取包，避免重新下载
    - apk --cache-dir $APK_CACHE_DIR add --no-cache $APK_PACKAGES
  script:
    - /bin/bash .gitlab-ci.d/do_stuff1.sh

do_stuff2:
  <<: *job_config
  stage: build
  before_script:
    - mkdir -p $APK_CACHE_DIR
    - apk --cache-dir $APK_CACHE_DIR add --no-cache $APK_PACKAGES
  script:
    - /bin/bash .gitlab-ci.d/do_stuff2.sh

关键调整说明 #

• 提前创建缓存目录：所有执行apk命令的job都要先运行mkdir -p $APK_CACHE_DIR，确保目录存在，否则apk会跳过缓存写入操作。
• 强制写入缓存索引：apk update添加--update-cache参数，让apk将更新的软件源索引写入指定的缓存目录，而不是只更新系统默认的索引文件。
• 后续Job复用缓存：使用apk add --no-cache配合--cache-dir，让apk优先从自定义缓存目录读取已下载的包，跳过系统默认缓存，确保复用之前缓存的文件。

可选优化 #

如果想避免每次prepare job都更新索引，可以添加缓存存在判断，减少不必要的网络请求：

- if [ ! -f $APK_CACHE_DIR/APKINDEX.tar.gz ]; then apk update --cache-dir $APK_CACHE_DIR --update-cache; fi

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