diff --git a/README.md b/README.md index f39d7c5a9..65798a5ee 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,7 @@ Rclone *("rsync for cloud storage")* is a command-line program to sync files and * Enterprise File Fabric [:page_facing_up:](https://rclone.org/filefabric/) * Fastmail Files [:page_facing_up:](https://rclone.org/webdav/#fastmail-files) * Files.com [:page_facing_up:](https://rclone.org/filescom/) + * FlashBlade [:page_facing_up:](https://rclone.org/s3/#pure-storage-flashblade) * FTP [:page_facing_up:](https://rclone.org/ftp/) * GoFile [:page_facing_up:](https://rclone.org/gofile/) * Google Cloud Storage [:page_facing_up:](https://rclone.org/googlecloudstorage/) diff --git a/backend/s3/s3.go b/backend/s3/s3.go index dd7d7dcb0..bde3dc699 100644 --- a/backend/s3/s3.go +++ b/backend/s3/s3.go @@ -101,6 +101,9 @@ var providerOption = fs.Option{ }, { Value: "Dreamhost", Help: "Dreamhost DreamObjects", + }, { + Value: "FlashBlade", + Help: "Pure Storage FlashBlade Object Storage", }, { Value: "GCS", Help: "Google Cloud Storage", @@ -567,7 +570,7 @@ func init() { }, { Name: "region", Help: "Region to connect to.\n\nLeave blank if you are using an S3 clone and you don't have a region.", - Provider: "!AWS,Alibaba,ArvanCloud,ChinaMobile,Cloudflare,IONOS,Petabox,Liara,Linode,Magalu,Qiniu,RackCorp,Scaleway,Selectel,Storj,Synology,TencentCOS,HuaweiOBS,IDrive", + Provider: "!AWS,Alibaba,ArvanCloud,ChinaMobile,Cloudflare,FlashBlade,IONOS,Petabox,Liara,Linode,Magalu,Qiniu,RackCorp,Scaleway,Selectel,Storj,Synology,TencentCOS,HuaweiOBS,IDrive", Examples: []fs.OptionExample{{ Value: "", Help: "Use this if unsure.\nWill use v4 signatures and an empty region.", @@ -1908,7 +1911,7 @@ func init() { }, { Name: "location_constraint", Help: "Location constraint - must be set to match the Region.\n\nLeave blank if not sure. Used when creating buckets only.", - Provider: "!AWS,Alibaba,ArvanCloud,HuaweiOBS,ChinaMobile,Cloudflare,IBMCOS,IDrive,IONOS,Leviia,Liara,Linode,Magalu,Outscale,Qiniu,RackCorp,Scaleway,Selectel,StackPath,Storj,TencentCOS,Petabox", + Provider: "!AWS,Alibaba,ArvanCloud,HuaweiOBS,ChinaMobile,Cloudflare,FlashBlade,IBMCOS,IDrive,IONOS,Leviia,Liara,Linode,Magalu,Outscale,Qiniu,RackCorp,Scaleway,Selectel,StackPath,Storj,TencentCOS,Petabox", }, { Name: "acl", Help: `Canned ACL used when creating buckets and storing or copying objects. @@ -1923,7 +1926,7 @@ doesn't copy the ACL from the source but rather writes a fresh one. If the acl is an empty string then no X-Amz-Acl: header is added and the default (private) will be used. `, - Provider: "!Storj,Selectel,Synology,Cloudflare", + Provider: "!Storj,Selectel,Synology,Cloudflare,FlashBlade", Examples: []fs.OptionExample{{ Value: "default", Help: "Owner gets Full_CONTROL.\nNo one else has access rights (default).", @@ -1981,6 +1984,7 @@ isn't set then "acl" is used instead. If the "acl" and "bucket_acl" are empty strings then no X-Amz-Acl: header is added and the default (private) will be used. `, + Provider: "!Storj,Selectel,Synology,Cloudflare,FlashBlade", Advanced: true, Examples: []fs.OptionExample{{ Value: "private", @@ -3495,6 +3499,9 @@ func setQuirks(opt *Options) { case "Dreamhost": urlEncodeListings = false useAlreadyExists = false // untested + case "FlashBlade": + mightGzip = false // Never auto gzips objects + virtualHostStyle = false // supports vhost but defaults to paths case "IBMCOS": listObjectsV2 = false // untested virtualHostStyle = false diff --git a/docs/content/_index.md b/docs/content/_index.md index 1a1c7fc79..64ce9ed52 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="Enterprise File Fabric" home="https://storagemadeeasy.com/about/" config="/filefabric/" >}} {{< provider name="Fastmail Files" home="https://www.fastmail.com/" config="/webdav/#fastmail-files" >}} {{< provider name="Files.com" home="https://www.files.com/" config="/filescom/" >}} +{{< provider name="FlashBlade" home="https://www.purestorage.com/products/unstructured-data-storage.html" config="/s3/#pure-storage-flashblade" >}} {{< provider name="FTP" home="https://en.wikipedia.org/wiki/File_Transfer_Protocol" config="/ftp/" >}} {{< provider name="Gofile" home="https://gofile.io/" config="/gofile/" >}} {{< provider name="Google Cloud Storage" home="https://cloud.google.com/storage/" config="/googlecloudstorage/" >}} diff --git a/docs/content/s3.md b/docs/content/s3.md index b9b8ad5d6..5db2d5ff5 100644 --- a/docs/content/s3.md +++ b/docs/content/s3.md @@ -29,6 +29,7 @@ The S3 backend can be used with a number of different providers: {{< provider name="Minio" home="https://www.minio.io/" config="/s3/#minio" >}} {{< provider name="Outscale" home="https://en.outscale.com/storage/outscale-object-storage/" config="/s3/#outscale" >}} {{< provider name="Petabox" home="https://petabox.io/" config="/s3/#petabox" >}} +{{< provider name="Pure Storage FlashBlade" home="https://www.purestorage.com/products/unstructured-data-storage.html" config="/s3/#pure-storage-flashblade" >}} {{< provider name="Qiniu Cloud Object Storage (Kodo)" home="https://www.qiniu.com/en/products/kodo" config="/s3/#qiniu" >}} {{< provider name="RackCorp Object Storage" home="https://www.rackcorp.com/" config="/s3/#RackCorp" >}} {{< provider name="Rclone Serve S3" home="/commands/rclone_serve_s3/" config="/s3/#rclone" >}} @@ -5482,6 +5483,119 @@ region = us-east-1 endpoint = s3.petabox.io ``` +### Pure Storage FlashBlade + +[Pure Storage FlashBlade](https://www.purestorage.com/products/unstructured-data-storage.html) is a high performance S3-compatible object store. + +FlashBlade supports most modern S3 features including: + +- ListObjectsV2 +- Multipart uploads with AWS-compatible ETags +- Advanced checksum algorithms (SHA256, CRC32, CRC32C) with trailer support (Purity//FB 4.4.2+) +- Object versioning and lifecycle management +- Virtual hosted-style requests (requires DNS configuration) + +To configure rclone for Pure Storage FlashBlade: + +First run: + + rclone config + +This will guide you through an interactive setup process: + +``` +No remotes found, make a new one? +n) New remote +s) Set configuration password +q) Quit config +n/s/q> n + +Enter name for new remote. +name> flashblade + +Option Storage. +Type of storage to configure. +Choose a number from below, or type in your own value. +[snip] + 4 / Amazon S3 Compliant Storage Providers including AWS, Alibaba, ArvanCloud, Ceph, ChinaMobile, Cloudflare, DigitalOcean, Dreamhost, FlashBlade, GCS, HuaweiOBS, IBMCOS, IDrive, IONOS, LyveCloud, Leviia, Liara, Linode, Magalu, Minio, Netease, Outscale, Petabox, RackCorp, Rclone, Scaleway, SeaweedFS, Selectel, StackPath, Storj, Synology, TencentCOS, Wasabi, Qiniu and others + \ (s3) +[snip] +Storage> s3 + +Option provider. +Choose your S3 provider. +Choose a number from below, or type in your own value. +Press Enter to leave empty. +[snip] + 9 / Pure Storage FlashBlade Object Storage + \ (FlashBlade) +[snip] +provider> FlashBlade + +Option env_auth. +Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). +Only applies if access_key_id and secret_access_key is blank. +Choose a number from below, or type in your own boolean value (true or false). +Press Enter for the default (false). + 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. +Leave blank for anonymous access or runtime credentials. +Enter a value. Press Enter to leave empty. +access_key_id> ACCESS_KEY_ID + +Option secret_access_key. +AWS Secret Access Key (password). +Leave blank for anonymous access or runtime credentials. +Enter a value. Press Enter to leave empty. +secret_access_key> SECRET_ACCESS_KEY + +Option endpoint. +Endpoint for S3 API. +Required when using an S3 clone. +Enter a value. Press Enter to leave empty. +endpoint> https://s3.flashblade.example.com + +Edit advanced config? +y) Yes +n) No (default) +y/n> n + +Configuration complete. +Options: +- type: s3 +- provider: FlashBlade +- access_key_id: ACCESS_KEY_ID +- secret_access_key: SECRET_ACCESS_KEY +- endpoint: https://s3.flashblade.example.com +Keep this "flashblade" remote? +y) Yes this is OK (default) +e) Edit this remote +d) Delete this remote +y/e/d> y +``` + +This results in the following configuration being stored in `~/.config/rclone/rclone.conf`: + +``` +[flashblade] +type = s3 +provider = FlashBlade +access_key_id = ACCESS_KEY_ID +secret_access_key = SECRET_ACCESS_KEY +endpoint = https://s3.flashblade.example.com +``` + +Note: The FlashBlade endpoint should be the S3 data VIP. For virtual-hosted style requests, +ensure proper DNS configuration: subdomains of the endpoint hostname should resolve to a +FlashBlade data VIP. For example, if your endpoint is `https://s3.flashblade.example.com`, +then `bucket-name.s3.flashblade.example.com` should also resolve to the data VIP. + ### Storj Storj is a decentralized cloud storage which can be used through its diff --git a/fstest/test_all/config.yaml b/fstest/test_all/config.yaml index 9facf06c1..b8aec57e8 100644 --- a/fstest/test_all/config.yaml +++ b/fstest/test_all/config.yaml @@ -284,6 +284,9 @@ backends: fastlist: true ignore: - TestIntegration/FsMkdir/FsPutFiles/SetTier + # - backend: "s3" + # remote: "TestS3FlashBlade:" + # fastlist: true - backend: "sftp" remote: "TestSFTPOpenssh:" fastlist: false