satackey/action-google-drive

与Google Drive交互的GitHub Action

镜像概述

此镜像为GitHub Action工具，用于在CI/CD工作流中实现与Google Drive之间的文件上传和下载操作，依赖skicka工具完成交互，需通过GitHub Secrets配置认证信息。

核心功能

• 上传本地文件到Google Drive指定路径
• 从Google Drive指定路径下载文件到本地
• 支持自定义Google Drive API客户端ID和密钥
• 可配置是否删除Google Drive中本地不存在的过时文件

使用场景

• CI/CD流程中上传构建产物到Google Drive存储
• 从Google Drive获取依赖文件或配置资源到工作流环境
• 自动化备份工作流生成的文件到Google Drive

配置说明

前置准备

1. 生成skicka令牌缓存文件：
   • 已使用skicka的用户：获取本地~/.skicka.tokencache.json内容
   • 首次使用：执行Docker命令生成令牌（参考官方步骤）
2. 在GitHub仓库Settings→Secrets中添加：
   • SKICKA_TOKENCACHE_JSON：令牌缓存内容（必填）
   • GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET：自定义客户端ID/密钥（可选，解决首次登录问题时需配置）

使用示例

上传文件

yaml
- name: 上传到Google Drive
  uses: satackey/action-google-drive@v1
  with:
    skicka-tokencache-json: ${{ secrets.SKICKA_TOKENCACHE_JSON }}
    upload-from: ./
    upload-to: /目标路径
    # 可选：自定义客户端ID/密钥
    # google-client-id: ${{ secrets.GOOGLE_CLIENT_ID }}
    # google-client-secret: ${{ secrets.GOOGLE_CLIENT_SECRET }}

下载文件

yaml
- name: 从Google Drive下载
  uses: satackey/action-google-drive@v1
  with:
    skicka-tokencache-json: ${{ secrets.SKICKA_TOKENCACHE_JSON }}
    download-from: /源路径
    download-to: ./
    # 可选：自定义客户端ID/密钥
    # google-client-id: ${{ secrets.GOOGLE_CLIENT_ID }}
    # google-client-secret: ${{ secrets.GOOGLE_CLIENT_SECRET }}

输入参数说明

• skicka-tokencache-json：必填，skicka生成的认证令牌缓存内容
• upload-from：可选，上传源路径，默认当前目录
• upload-to：上传时必填，Google Drive目标路径
• download-from：下载时必填，Google Drive源路径
• download-to：可选，下载目标路径，默认当前目录
• google-client-id/google-client-secret：可选，自定义Google API客户端ID/密钥
• remove-outdated：可选，是否删除Google Drive中本地不存在的文件，默认'true'（大文件操作建议设为'false'）