docker_recipes CI缓存镜像文档

概述

docker_recipes CI缓存镜像是专为docker_recipes项目设计的持续集成(CI)缓存解决方案，旨在通过高效管理构建依赖缓存，优化CI流水线性能，减少重复资源下载，提升构建效率。

核心功能和特性

• 缓存存储管理：提供专用存储机制，集中保存构建过程中的依赖文件、编译产物等缓存数据
• 自动化缓存生命周期：支持缓存的自动创建、更新、清理，无需手动干预
• 跨构建共享：实现缓存数据在多次CI构建任务间的共享，保持依赖一致性
• 冗余资源优化：有效减少外部依赖（如包管理器资源、Docker镜像层）的重复下载，降低网络带宽消耗
• 轻量级架构：镜像体积小巧，启动快速，对CI环境资源占用低，适配各类CI/CD平台

使用场景和适用范围

• docker_recipes项目CI/CD流水线：作为docker_recipes构建流程的核心组件，优化依赖管理环节
• 高频次构建环境：适用于开发团队日常开发中的高频代码提交与构建场景
• 依赖密集型项目：针对依赖大量外部库、工具或Docker镜像的项目，显著缩短构建时间
• 自动化测试环境：在持续测试流程中，加速测试环境的部署与准备过程

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  --name ci-cache \
  -v /path/to/local/cache:/cache \
  -e CACHE_DIR=/cache \
  -e MAX_SIZE=10G \
  -e TTL=7d \
  docker_recipes/ci-cache:latest

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  ci-cache:
    image: docker_recipes/ci-cache:latest
    volumes:
      - ci_cache_volume:/cache
    environment:
      - CACHE_DIR=/cache
      - MAX_SIZE=15G
      - TTL=14d
      - CLEANUP_POLICY=LRU
    restart: unless-stopped

volumes:
  ci_cache_volume:
    driver: local

CI流水线集成示例（GitLab CI）

在.gitlab-ci.yml中配置缓存挂载与同步：

yaml
variables:
  CACHE_SERVICE: ci-cache

before_script:
  # 从缓存加载依赖
  - docker run --rm --volumes-from $CACHE_SERVICE -v $(pwd)/dependencies:/app/dependencies alpine sh -c "cp -r /cache/dependencies/* /app/dependencies/ 2>/dev/null || true"

after_script:
  # 保存依赖到缓存
  - docker run --rm --volumes-from $CACHE_SERVICE -v $(pwd)/dependencies:/app/dependencies alpine cp -r /app/dependencies/* /cache/dependencies/