quintoandar/drone-gcs-sync

drone-gcs-sync

drone-gcs-sync是一个Drone CI/CD插件，用于执行Google Cloud Storage的gsutil -m rsync命令，实现本地文件与GCS存储桶之间的同步操作。

核心功能

• 同步本地目录到指定GCS存储桶路径
• 支持删除目标存储桶中不存在于源目录的文件（需谨慎使用）
• 提供dry-run模式，预览同步操作而不实际修改数据
• 支持调试模式，打印执行的命令（不泄露凭据）
• 无缝集成Drone流水线，实现自动化同步流程

使用场景

• CI/CD流水线中，将构建生成的静态资源（如前端打包文件）同步到GCS存储桶，用于静态网站托管
• 定期同步本地数据到GCS进行备份
• 自动化部署静态内容到GCS存储桶

配置说明

参数列表

Docker部署示例

构建镜像

bash
docker build --rm=true -t quintoandar/drone-gcs-sync .

本地运行

bash
docker run --rm \
  -e PLUGIN_BUCKET=my-bucket \
  -e PLUGIN_TARGET=bucket/target/folder \
  -e PLUGIN_SOURCE=my/local/folder \
  -e PLUGIN_DELETE=false \
  -e PLUGIN_DRY_RUN=true \
  -e GOOGLE_APPLICATION_CREDENTIALS=... \
  -v $(pwd):$(pwd) \
  -w $(pwd) \
  quintoandar/drone-gcs-sync

Drone流水线配置（测试于0.8.5版本）

yaml
tag:
  group: publish
  image: quintoandar/drone-gcs-sync
  bucket: my-bucket
  target: bucket/target/folder
  source: my/local/folder
  delete: false
  dry_run: true
  secrets:
      - google_application_credentials
  when:
    branch: ["master"]
    event: ["push"]

警告

PLUGIN_DELETE参数等价于执行gsutil -m rsync -d ...，它能让目标存储桶的内容与源目录保持一致，非常实用。但使用时需格外小心：例如若错误颠倒源和目标路径，可能会意外删除大量数据。
使用PLUGIN_DELETE时，务必先通过PLUGIN_DRY_RUN模式预览操作，确保不会误删过多内容。