Skip to content

Commit f627b02

Browse files
committed
docs(feature-flags): add guidance when to use vs env vars vs parameters
1 parent 1a21b3f commit f627b02

File tree

2 files changed

+10
-0
lines changed

2 files changed

+10
-0
lines changed

Diff for: CHANGELOG.md

+2
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ This project follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) fo
1414
* **deps:** bump poetry to latest ([#592](https://github.com/awslabs/aws-lambda-powertools-python/issues/592))
1515
* **feature-flags:** bug handling multiple conditions ([#599](https://github.com/awslabs/aws-lambda-powertools-python/issues/599))
1616
* **parser:** API Gateway WebSocket validation under check_message_id; plus some housekeeping ([#553](https://github.com/awslabs/aws-lambda-powertools-python/issues/553))
17+
* **feature-toggles:** correct cdk example ([#601](https://github.com/awslabs/aws-lambda-powertools-python/issues/601))
1718

1819
### Code Refactoring
1920

@@ -30,6 +31,7 @@ This project follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) fo
3031
* **tracer:** update wording that it auto-disables on non-Lambda env
3132
* **feature-flags:** fix SAM infra, convert CDK to Python
3233
* **feature-flags:** fix sample feature name in evaluate method
34+
* **feature-flags:** add guidance when to use vs env vars vs parameters
3335
### Features
3436

3537
* **api-gateway:** add support for custom serializer ([#568](https://github.com/awslabs/aws-lambda-powertools-python/issues/568))

Diff for: docs/utilities/feature_flags.md

+8
Original file line numberDiff line numberDiff line change
@@ -644,3 +644,11 @@ You can unit test your feature flags locally and independently without setting u
644644
# THEN
645645
assert flag == expected_value
646646
```
647+
648+
## Feature flags vs Parameters vs env vars
649+
650+
Method | When to use | Requires new deployment on changes | Supported services
651+
------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------- | -------------------------------------------------
652+
**[Environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html){target="_blank"}** | Simple configuration that will rarely if ever change, because changing it requires a Lambda function deployment. | Yes | Lambda
653+
**[Parameters utility](parameters.md)** | Access to secrets, or fetch parameters in different formats from AWS System Manager Parameter Store or Amazon DynamoDB. | No | Parameter Store, DynamoDB, Secrets Manager, AppConfig
654+
**Feature flags utility** | Rule engine to define when one or multiple features should be enabled depending on the input. | No | AppConfig

0 commit comments

Comments
 (0)