From bb26fd603fb3bb3657c228b1657f0e4b4ba1a482 Mon Sep 17 00:00:00 2001 From: Austin Workman Date: Mon, 11 Jul 2022 16:06:34 -0500 Subject: [PATCH] Add support for S3 path based addressing --- .changelog/_2271.txt | 3 +++ website/content/commands/snapshot/agent.mdx | 7 ++++++- 2 files changed, 9 insertions(+), 1 deletion(-) create mode 100644 .changelog/_2271.txt diff --git a/.changelog/_2271.txt b/.changelog/_2271.txt new file mode 100644 index 000000000..58dc78dfa --- /dev/null +++ b/.changelog/_2271.txt @@ -0,0 +1,3 @@ +```release-note:improvement +snapshot agent: **(Enterprise only)** Add support for path-based addressing when using s3 backend. +``` \ No newline at end of file diff --git a/website/content/commands/snapshot/agent.mdx b/website/content/commands/snapshot/agent.mdx index c565a52e6..7607fc2b5 100644 --- a/website/content/commands/snapshot/agent.mdx +++ b/website/content/commands/snapshot/agent.mdx @@ -168,7 +168,8 @@ Usage: `consul snapshot agent [options]` "s3_bucket": "", "s3_key_prefix": "consul-snapshot", "s3_server_side_encryption": false, - "s3_static_snapshot_name": "" + "s3_static_snapshot_name": "", + "s3_force_path_style": false }, "azure_blob_storage": { "account_name": "", @@ -275,6 +276,10 @@ Note that despite the AWS references, any S3-compatible endpoint can be specifie - `-aws-s3-static-snapshot-name` - If this is given, all snapshots are saved with the same file name. The agent will not rotate or version snapshots, and will save them with the same name each time. Use this if you want to rely on [S3's versioning capabilities](http://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html) instead of the agent handling it for you. +- `-aws-s3-force-path-style` - Enables the use of legacy path-based addressing instead of virtual addressing. This flag is required by minio + and other 3rd party S3 compatible object storage platforms where DNS or TLS requirements for virtual addressing are prohibitive. +For more information, refer to the AWS documentation on [Methods for accessing a bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html) + - `-aws-s3-enable-kms` - Enables using [Amazon KMS](https://aws.amazon.com/kms/) for encrypting snapshots. - `-aws-s3-kms-key` - Optional Amazon KMS key to use, if this is not set the default KMS master key will be used. Set this if you want to manage key rotation yourself.