"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files
Go azure-blobazure-blob-storageazure-filesbackblaze-b2cloud-storagedropboxencryptionftpfuse-filesystemgogolanggoogle-cloud-storagegoogle-driveonedriveopenstack-swiftrclones3sftpsyncwebdav
s3: add Clever Cloud Cellar provider
David Legrandea588aac1e24
diff --git a/README.md b/README.mdindex 06f5e34e8..f5705b2ad 100644--- a/README.md+++ b/README.md@@ -35,6 +35,7 @@ directories to and from different cloud storage providers.- Ceph [:page_facing_up:](https://rclone.org/s3/#ceph)- China Mobile Ecloud Elastic Object Storage (EOS) [:page_facing_up:](https://rclone.org/s3/#china-mobile-ecloud-eos)- Citrix ShareFile [:page_facing_up:](https://rclone.org/sharefile/)+- Clever Cloud Cellar [:page_facing_up:](https://rclone.org/s3/#clever-cloud-cellar)- Cloudflare R2 [:page_facing_up:](https://rclone.org/s3/#cloudflare-r2)- Cloudinary [:page_facing_up:](https://rclone.org/cloudinary/)- Cubbit DS3 [:page_facing_up:](https://rclone.org/s3/#Cubbit)diff --git a/backend/s3/provider/Cellar.yaml b/backend/s3/provider/Cellar.yamlnew file mode 100644index 000000000..f4532279f--- /dev/null+++ b/backend/s3/provider/Cellar.yaml@@ -0,0 +1,15 @@+name: Cellar+description: Clever Cloud Cellar Object Storage+endpoint:+ cellar-c2.services.clever-cloud.com: Paris, France+acl: {}+bucket_acl: true+sse_customer_algorithm: true+sse_customer_key: true+sse_customer_key_base64: true+sse_customer_key_md5: true+quirks:+ # Object Lock headers are not applied on CreateMultipartUpload, so the+ # Object Lock tests are skipped. Users should set+ # --s3-object-lock-set-after-upload when using Object Lock.+ object_lock_supported: falsediff --git a/docs/content/_index.md b/docs/content/_index.mdindex 639ede4d6..6bffa04a4 100644--- a/docs/content/_index.md+++ b/docs/content/_index.md@@ -124,6 +124,7 @@ WebDAV or S3, that work out of the box.){{< provider name="China Mobile Ecloud Elastic Object Storage (EOS)" home="https://ecloud.10086.cn/home/product-introduction/eos/" config="/s3/#china-mobile-ecloud-eos" >}}{{< provider name="Arvan Cloud Object Storage (AOS)" home="https://www.arvancloud.ir/en/products/cloud-storage" config="/s3/#arvan-cloud" >}}{{< provider name="Citrix ShareFile" home="http://sharefile.com/" config="/sharefile/" >}}+{{< provider name="Clever Cloud Cellar" home="https://www.clever.cloud/product/cellar-object-storage/" config="/s3/#clever-cloud-cellar" >}}{{< provider name="Cloudflare R2" home="https://blog.cloudflare.com/r2-open-beta/" config="/s3/#cloudflare-r2" >}}{{< provider name="Cloudinary" home="https://cloudinary.com/" config="/cloudinary/" >}}{{< provider name="Cubbit DS3" home="https://cubbit.io/ds3-cloud" config="/s3/#Cubbit" >}}diff --git a/docs/content/s3.md b/docs/content/s3.mdindex 91d75d754..20abaef7a 100644--- a/docs/content/s3.md+++ b/docs/content/s3.md@@ -16,6 +16,7 @@ The S3 backend can be used with a number of different providers:{{< provider name="Alibaba Cloud (Aliyun) Object Storage System (OSS)" home="https://www.alibabacloud.com/product/oss/" config="/s3/#alibaba-oss" >}}{{< provider name="Ceph" home="http://ceph.com/" config="/s3/#ceph" >}}{{< provider name="China Mobile Ecloud Elastic Object Storage (EOS)" home="https://ecloud.10086.cn/home/product-introduction/eos/" config="/s3/#china-mobile-ecloud-eos" >}}+{{< provider name="Clever Cloud Cellar" home="https://www.clever.cloud/product/cellar-object-storage/" config="/s3/#clever-cloud-cellar" >}}{{< provider name="Cloudflare R2" home="https://blog.cloudflare.com/r2-open-beta/" config="/s3/#cloudflare-r2" >}}{{< provider name="Arvan Cloud Object Storage (AOS)" home="https://www.arvancloud.com/en/products/cloud-storage" config="/s3/#arvan-cloud" >}}{{< provider name="Autonomys Auto Drive" home="https://ai3.storage/" config="/s3/#autonomys" >}}@@ -5538,6 +5539,117 @@ d) Delete this remotey/e/d> y```+### Clever Cloud Cellar {#clever-cloud-cellar}++[Cellar](https://www.clever.cloud/product/cellar-object-storage/) is the+S3-compatible object storage service of+[Clever Cloud](https://www.clever.cloud/), hosted in France. Credentials and the+endpoint are shown in the Cellar add-on dashboard, or in the+`CELLAR_ADDON_KEY_ID`, `CELLAR_ADDON_KEY_SECRET` and `CELLAR_ADDON_HOST`+environment variables of applications linked to it.++Cellar does not apply Object Lock headers sent when initiating a multipart+upload. When setting Object Lock retention or legal hold options, also set+`--s3-object-lock-set-after-upload`: the lock is then applied with separate API+calls after the upload, so the object is not protected by these settings until+those calls succeed.++Cellar supports server-side encryption with customer-provided keys (SSE-C), set+with `sse_customer_algorithm` and `sse_customer_key_base64`. It rejects+server-side copies of SSE-C objects unless they are done as multipart copies, so+use `--no-update-modtime` to avoid modification time updates, and expect+server-side moves and renames of encrypted objects smaller than+`--s3-copy-cutoff` to fail. See the+[Cellar SSE-C documentation](https://www.clever.cloud/developers/doc/deploy/storage/cellar/#server-side-encryption-with-customer-keys-sse-c).++First run:++```console+rclone config+```++```text+This will guide you through an interactive setup process:++n) New remote+n/s/q> n++Enter name for new remote.+name> cellar++Option Storage.+Type of storage to configure.+Choose a number from below, or type in your own value.+[snip]+XX / Amazon S3 Compliant Storage Providers including AWS, ..., Cellar, ... and others+ \ (s3)+Storage> s3++Option provider.+Choose your S3 provider.+[snip]+XX / Clever Cloud Cellar Object Storage+ \ (Cellar)+provider> Cellar++Option env_auth.+Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).+ 1 / Enter AWS credentials in the next step.+ \ (false)+ 2 / Get AWS credentials from the environment (env vars or IAM).+ \ (true)+env_auth> 1++Option access_key_id.+AWS Access Key ID.+access_key_id> ACCESS_KEY++Option secret_access_key.+AWS Secret Access Key (password).+secret_access_key> SECRET_KEY++Option endpoint.+Endpoint for S3 API.+ 1 / Paris, France+ \ (cellar-c2.services.clever-cloud.com)+endpoint> 1++Option acl.+Canned ACL used when creating buckets and storing or copying objects.+[snip]+acl> 1++Option bucket_object_lock_enabled.+Enable Object Lock when creating new buckets.+bucket_object_lock_enabled>++Edit advanced config?+y/n> n++Configuration complete.+Options:+- type: s3+- provider: Cellar+- access_key_id: ACCESS_KEY+- secret_access_key: SECRET_KEY+- endpoint: cellar-c2.services.clever-cloud.com+- acl: private+Keep this "cellar" remote?+y/e/d> y+```++This will leave the config file looking like this.++```ini+[cellar]+type = s3+provider = Cellar+access_key_id = ACCESS_KEY+secret_access_key = SECRET_KEY+endpoint = cellar-c2.services.clever-cloud.com+acl = private+```+### Cloudflare R2 {#cloudflare-r2}[Cloudflare R2](https://blog.cloudflare.com/r2-open-beta/) Storage