Google Cloud Storage Cache

by hvalle

The example Yaml configurations in this file are using the legacy 0.8 syntax. If you are using Drone 1.0 or Drone Cloud please ensure you use the appropriate 1.0 syntax. Learn more here.

The GCS cache plugin can be used to preserve files and directories between builds. The below pipeline configuration demonstrates simple usage:

pipeline:
  restore-cache:
    image: homerovalle/drone-gcs-cache
    pull: true
    bucket: gcs_bucket
    json_key: your-service-account-json-key
    restore: true

  build:
    image: node
    commands:
      - npm install

  rebuild-cache:
    image: homerovalle/drone-gcs-cache
    pull: true
    bucket: gcs_bucket
    json_key: your-service-account-json-key
    rebuild: true
    mount:
      - node_modules
    when:
      event: push

  flush_cache:
    image: homerovalle/drone-gcs-cache
    pull: true
    bucket: gcs_bucket
    json_key: your-service-account-json-key
    flush: true
    flush_age: 14

Use additional custom cache directories:

pipeline:
  restore-cache:
    image: homerovalle/drone-gcs-cache
    pull: true
    bucket: gcs_bucket
    json_key: your-service-account-json-key
    restore: true

  build:
    image: node
    commands:
      - npm install

  rebuild-cache:
    image: homerovalle/drone-gcs-cache
    pull: true
    bucket: gcs_bucket
    json_key: your-service-account-json-key
    rebuild: true
    mount:
-     - node_modules
+     - <yourstuffhere>
+     - <morestuffhere>
    when:
      event: push

  flush_cache:
    image: homerovalle/drone-gcs-cache
    pull: true
    bucket: gcs_bucket
    json_key: your-service-account-json-key
    flush: true
    flush_age: 14

Example configuration using credentials from secrets:

pipeline:
  restore-cache:
    image: homerovalle/drone-gcs-cache
    pull: true
    bucket: gcs_bucket
-   json_key: your-service-account-json-key
+   secrets: [ GCS_CACHE_JSON_KEY ]
    restore: true

  build:
    image: node
    commands:
      - npm install

  rebuild-cache:
    image: homerovalle/drone-gcs-cache
    pull: true
    bucket: gcs_bucket
-   json_key: your-service-account-json-key
+   secrets: [ GCS_CACHE_JSON_KEY ]
    rebuild: true
    mount:
      - node_modules
    when:
      event: push

  flush_cache:
    image: homerovalle/drone-gcs-cache
    pull: true
    bucket: gcs_bucket
-   json_key: your-service-account-json-key
+   secrets: [ GCS_CACHE_JSON_KEY ]
    flush: true
    flush_age: 14

Secret Reference

gcs_cache_json_key
service account json key

Parameter Reference

json_key
service account json key
restore
mode to restore the build environment from cache
rebuild
mode to rebuild the cache from the build environment and specified mounts
flush
mode to flush the cache of old cache items (please be sure to set this so we don’t waste storage)
flush_age
flush cache files older then # days, defaults to 30 (optional)
mount
list of files/directories to cache
debug
enabling more logging for debugging, defaults to false (optional)
filename
filename for the cache (optional)
bucket
bucket to use to rebuild and restore cache
path
path to store the cache file, defaults to [bucket]/<owner>/<repo>/<branch>/ (optional)
fallback_path
fallback path for the cache file, defaults to [bucket]/<owner>/<repo>/<branch>/ (optional)
flush_path
path to search for flushable cache files, defaults to [bucket]/<owner>/<repo>/ (optional)

这个网页有没有错误? 请让我们知道 或编辑 这个页面