symfonywithswoole/swoole-bundle-cache

镜像概述

Swoole Bundle CI构建缓存镜像是专为Swoole Bundle项目的持续集成(CI)流程设计的工具镜像，主要用于缓存构建过程中的依赖文件、编译产物等中间结果，避免每次CI构建时重复下载和处理相同资源，从而显著提升构建效率，缩短CI流程耗时。

核心功能与特性

1. 依赖与产物缓存

• 支持缓存Composer依赖、Swoole扩展编译产物等构建关键资源，减少重复下载和编译操作。
• 自动识别并存储构建过程中产生的可复用中间文件，确保缓存内容与项目构建环境匹配。

2. 构建效率优化

• 通过复用缓存资源，减少CI构建中的网络请求（如下载依赖包）和计算密集型操作（如源码编译），显著缩短构建时间。
• 降低外部资源依赖风险，避免因网络波动或资源地址变更导致的构建失败。

3. 兼容性与灵活性

• 兼容主流CI/CD平台（GitHub Actions、GitLab CI、Jenkins等），可无缝集成到各类自动化构建流程。
• 支持自定义缓存策略，可通过配置参数调整缓存有效期、清理规则等，适配不同项目需求。

使用场景

• Swoole Bundle项目CI构建：在代码提交触发的CI流程中，缓存依赖和中间产物，避免重复处理相同资源。
• 多分支并行构建：针对项目多开发分支的并行构建场景，共享通用依赖缓存，降低资源消耗。
• 高频迭代项目：适用于提交频率高、构建频繁的Swoole Bundle项目，提升开发迭代效率。

使用方法与配置说明

基本使用（Docker Run）

通过挂载缓存卷实现数据持久化，示例命令如下：

bash
docker run -d \
  --name swoole-bundle-ci-cache \
  -v /path/to/host/cache:/cache \
  -e CACHE_KEY=swoole-bundle-v1.0 \
  -e CACHE_TTL=604800 \
  swoole-bundle-ci-cache:latest

参数说明：

• -v /path/to/host/cache:/cache：将宿主机缓存目录挂载至容器内/cache目录，实现缓存数据持久化。
• -e CACHE_KEY：缓存标识，用于区分不同版本或环境的缓存（默认值：swoole-bundle-default）。
• -e CACHE_TTL：缓存有效期（秒），过期缓存将自动清理（默认值：604800，即7天）。

Docker Compose配置

在CI流程中通过docker-compose.yml定义缓存服务：

yaml
version: '3'
services:
  ci-cache:
    image: swoole-bundle-ci-cache:latest
    volumes:
      - ci_cache_volume:/cache
    environment:
      - CACHE_KEY=swoole-bundle-${CI_COMMIT_BRANCH}
      - CACHE_TTL=86400  # 缓存有效期1天

volumes:
  ci_cache_volume:
    driver: local

CI平台集成示例（GitHub Actions）

在.github/workflows/ci.yml中集成缓存服务：

yaml
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Start cache service
        run: |
          docker run -d \
            --name swoole-ci-cache \
            -v ${{ github.workspace }}/.ci-cache:/cache \
            -e CACHE_KEY=swoole-bundle-${{ github.ref_name }} \
            swoole-bundle-ci-cache:latest

      - name: Run Swoole Bundle build
        run: |
          export CACHE_DIR=${{ github.workspace }}/.ci-cache
          # 构建命令中引用缓存目录，如composer install --cache-dir=$CACHE_DIR/composer

注意事项

1. 权限配置：确保CI环境中挂载的缓存目录具有读写权限，避免因权限不足导致缓存失败。
2. 缓存清理：定期通过CACHE_TTL自动清理过期缓存，或手动执行docker exec swoole-bundle-ci-cache /scripts/cleanup.sh清理冗余数据。
3. 版本兼容：当项目依赖版本变更时，建议更新CACHE_KEY，避免旧缓存导致构建异常。