homerovalle/drone-gcs-cache

drone-gcs-cache镜像说明

镜像概述

drone-gcs-cache是基于https://github.com/drone-plugins/drone-s3-cache%E5%BC%80%E5%8F%91%E7%9A%84Drone CI/CD插件，专门用于将构建工作区中的目录缓存到Google Cloud Storage（GCS），帮助优化CI/CD流程，减少重复构建时间。

核心功能

• 支持将指定目录缓存到GCS桶中
• 从GCS桶恢复缓存目录，避免重复下载或编译依赖
• 与Drone CI/CD流程无缝集成，支持自定义缓存键和挂载路径

使用场景

• CI/CD构建中缓存依赖包（如node_modules、vendor等）
• 缓存编译后的中间产物，加速后续构建
• 跨构建任务共享通用资源，降低资源消耗

配置说明

关键配置参数：

• gcs_bucket: GCS桶名称
• gcs_credentials: Google Cloud服务账号凭证（JSON格式）
• cache_key: 缓存键（用于区分不同版本的缓存）
• mount: 需要缓存的目录路径（支持多个）
• action: 操作类型（save保存缓存/restore恢复缓存）

部署示例

Drone Pipeline配置

yaml
kind: pipeline
type: docker
name: default

steps:
- name: restore-cache
  image: homerovalle/drone-gcs-cache
  settings:
    action: restore
    gcs_bucket: my-cache-bucket
    gcs_credentials:
      from_secret: gcs_credentials
    cache_key: "{{ .Repo.Name }}-{{ checksum 'package.json' }}"
    mount:
      - node_modules

- name: build
  image: node:18
  commands:
    - npm install
    - npm run build

- name: save-cache
  image: homerovalle/drone-gcs-cache
  settings:
    action: save
    gcs_bucket: my-cache-bucket
    gcs_credentials:
      from_secret: gcs_credentials
    cache_key: "{{ .Repo.Name }}-{{ checksum 'package.json' }}"
    mount:
      - node_modules

Docker Run命令

bash
docker run \
  -e PLUGIN_ACTION=save \
  -e PLUGIN_GCS_BUCKET=my-cache-bucket \
  -e PLUGIN_GCS_CREDENTIALS='{"type":"service_account",...}' \
  -e PLUGIN_CACHE_KEY="my-project-$(sha256sum package.json | cut -d' ' -f1)" \
  -e PLUGIN_MOUNT=node_modules \
  -v $(pwd):/drone/src \
  homerovalle/drone-gcs-cache

更多配置细节请参考官方文档。