Skip to content

Storage Providers ​

Cloud Cache Action stores caches in any S3-compatible bucket. These pages give the set-up for nine providers: five cloud services and four self-hosted servers. The table compares them. Each row links to the full set-up page.

The action finds the provider, the region and the addressing style from the endpoint URL. To override the result, set the provider input.

ProviderCredentialsEndpoint formConditional writesObject tagsNotes
AWS S3GitHub OIDC with an IAM role, or static IAM user keysNo endpoint. Set region.Enforced (verified)Not statedA bucket with Object Lock default retention needs CLOUD_CACHE_SDK_CHECKSUMS: 'true'.
Cloudflare R2R2 API token, scoped to the buckethttps://<account-id>.r2.cloudflarestorage.comNot statedNot statedThe action sets region: auto from the endpoint. Zero egress fees.
Google Cloud Storage (GCS)HMAC key of a dedicated service accounthttps://storage.googleapis.comReportedly ignored: last-writer-winsNo tagging APIThe action sets path-style addressing. A streamed save attaches its checksum with a copy.
Backblaze B2Application key, restricted to the buckethttps://s3.<region>.backblazeb2.comNot statedNot statedThe action reads the region from the endpoint.
Fastly Object StorageAccess key pair, scoped to the buckethttps://object.<region>.fastlystorage.comNot statedNot stated
Garage (self-hosted)Garage key with --read --write on the buckethttp://<host>:3900, with provider: garageNot supported: last-writer-wins (verified)Accepted on upload, cannot be read backMetadata and the sha256 check work.
SeaweedFS (self-hosted)Identity in s3.jsonhttp://<host>:8333, with provider: seaweedfsEnforced (verified)Verifiedprune cannot abort incomplete uploads on SeaweedFS 4.46.
MinIO (self-hosted)Service account with a bucket policyhttps://<host>:9000, with force-path-style: trueEnforced (verified)Verifiedprune finds no incomplete uploads. Use an ILM rule.
RustFS (self-hosted)Dedicated user with a bucket policyhttps://<host>:9000, with provider: rustfsEnforced (verified)VerifiedWithout provider, the log shows an endpoint on port 9000 as minio.

"Verified" means that the integration suite or a provider page measured the behavior. "Not stated" means that these docs do not give the behavior for that provider. The sources are Safe Concurrent Saves, Object Metadata and Tags and the provider pages.

What every provider needs ​

  • A private bucket. The action never creates a bucket.
  • Credentials that can read, write and list objects in the bucket. The Security guide gives least-privilege policies for AWS S3, Cloudflare R2, Google Cloud Storage, MinIO and RustFS.
  • A lifecycle rule or the prune sub-action. The action never deletes caches.

Conditional writes ​

A save uses a conditional create (If-None-Match: *). On a provider that enforces it, the first of two concurrent saves of one key wins, and the second save keeps that cache. On a provider that ignores it, the last save wins.

Object tags ​

A streamed save attaches its sha256 checksum as an object tag. On a provider without a tagging API, the save attaches the checksum with a copy of the object onto itself. See How Caches Are Stored.