@@ -8,16 +8,19 @@ For detailed info about using chamber, please read
88
99## v3.0 Breaking Changes
1010
11- _ Version 3.0 has not yet been released. Changes described here are forward-looking._
12-
1311* ** Use of the SSM Parameter Store's path-based API is now required.** Support
1412 added in v2.0 to avoid it has been removed. The ` CHAMBER_NO_PATHS ` environment
1513 variable no longer has any effect. You must migrate to the new storage format
16- using the instructions below.
14+ using the instructions below, using a 2.x version of chamber .
1715* ** The ` --min-throttle-delay ` option no longer has any effect.** Support for
1816 specifying a minimum throttle delay has been removed from the underlying AWS
1917 SDK with no direct replacement. Instead, set the new ` --retry-mode ` option to
2018 "adaptive" to use an experimental model that accounts for throttling errors.
19+ * ** Context arguments are required for ` Store ` methods.** This is a consequence
20+ of migrating to a new AWS SDK. This change has no effect for CLI users, but
21+ those using chamber as a library must update their code to pass contexts.
22+ * ** The deprecated ` NewS3Store ` constructor has been removed.** Use
23+ ` NewS3StoreWithBucket ` instead.
2124
2225## v2.0 Breaking Changes
2326
@@ -52,7 +55,7 @@ at the time of release.
5255If you have a functional go environment, you can install with:
5356
5457``` bash
55- go install github.com/segmentio/chamber/v2 @latest
58+ go install github.com/segmentio/chamber/v3 @latest
5659```
5760
5861### Caveat About ` chamber version ` and ` go install `
@@ -443,7 +446,7 @@ you can use `CHAMBER_AWS_REGION` to override just for chamber.
443446### Custom SSM Endpoint
444447
445448If you' d like to use a custom SSM endpoint for chamber, you can use `CHAMBER_AWS_SSM_ENDPOINT`
446- to override AWS default URL.
449+ to override the default URL.
447450
448451## AWS Secrets Manager
449452Chamber supports AWS Secrets Manager as an optional backend. For example:
@@ -453,6 +456,16 @@ chamber -b secretsmanager write myservice foo fah
453456chamber -b secretsmanager write myservice foo2 fah2
454457```
455458
459+ ### Custom Secrets Manager Endpoint
460+
461+ If you' d like to use a custom Secrets Manager endpoint for chamber, you can use
462+ ` CHAMBER_AWS_SECRETS_MANAGER_ENDPOINT` to override the default URL.
463+
464+ > [!WARNING]
465+ > Prior to v3.0.0, the endpoint could also be overridden with ` CHAMBER_AWS_SSM_ENDPOINT` . This
466+ > has been deprecated and will stop working in a future chamber release. Please use
467+ > ` CHAMBER_AWS_SECRETS_MANAGER_ENDPOINT` instead.
468+
456469## S3 Backend (Experimental)
457470
458471By default, chamber store secrets in AWS Parameter Store. We now also provide an
0 commit comments