Skip to content

"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files

s3: add Clever Cloud Cellar provider

David Legrandea588aac1e24
diff --git a/README.md b/README.md
index 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.yaml
new file mode 100644
index 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: false
diff --git a/docs/content/_index.md b/docs/content/_index.md
index 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.md
index 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 remote
y/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