Add support for S3 path based addressing

This commit is contained in:
Austin Workman 2022-07-11 16:06:34 -05:00 committed by freddygv
parent f5139f0c17
commit bb26fd603f
2 changed files with 9 additions and 1 deletions

3
.changelog/_2271.txt Normal file
View File

@ -0,0 +1,3 @@
```release-note:improvement
snapshot agent: **(Enterprise only)** Add support for path-based addressing when using s3 backend.
```

View File

@ -168,7 +168,8 @@ Usage: `consul snapshot agent [options]`
"s3_bucket": "", "s3_bucket": "",
"s3_key_prefix": "consul-snapshot", "s3_key_prefix": "consul-snapshot",
"s3_server_side_encryption": false, "s3_server_side_encryption": false,
"s3_static_snapshot_name": "" "s3_static_snapshot_name": "",
"s3_force_path_style": false
}, },
"azure_blob_storage": { "azure_blob_storage": {
"account_name": "", "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. - `-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. 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-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. - `-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.