@@ -8,16 +8,19 @@ For detailed info about using chamber, please read
8
8
9
9
## v3.0 Breaking Changes
10
10
11
- _ Version 3.0 has not yet been released. Changes described here are forward-looking._
12
-
13
11
* ** Use of the SSM Parameter Store's path-based API is now required.** Support
14
12
added in v2.0 to avoid it has been removed. The ` CHAMBER_NO_PATHS ` environment
15
13
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 .
17
15
* ** The ` --min-throttle-delay ` option no longer has any effect.** Support for
18
16
specifying a minimum throttle delay has been removed from the underlying AWS
19
17
SDK with no direct replacement. Instead, set the new ` --retry-mode ` option to
20
18
"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.
21
24
22
25
## v2.0 Breaking Changes
23
26
@@ -52,7 +55,7 @@ at the time of release.
52
55
If you have a functional go environment, you can install with:
53
56
54
57
``` bash
55
- go install github.com/segmentio/chamber/v2 @latest
58
+ go install github.com/segmentio/chamber/v3 @latest
56
59
```
57
60
58
61
### Caveat About ` chamber version ` and ` go install `
@@ -443,7 +446,7 @@ you can use `CHAMBER_AWS_REGION` to override just for chamber.
443
446
### Custom SSM Endpoint
444
447
445
448
If 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.
447
450
448
451
## AWS Secrets Manager
449
452
Chamber supports AWS Secrets Manager as an optional backend. For example:
@@ -453,6 +456,16 @@ chamber -b secretsmanager write myservice foo fah
453
456
chamber -b secretsmanager write myservice foo2 fah2
454
457
```
455
458
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
+
456
469
## S3 Backend (Experimental)
457
470
458
471
By default, chamber store secrets in AWS Parameter Store. We now also provide an
0 commit comments