Skip to content

Add MERGE_STRATEGY environment variable #240

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Sep 29, 2025
Merged

Add MERGE_STRATEGY environment variable #240

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b583dea
add config variable
giograno Sep 28, 2025
a62eed1
fix url
giograno Sep 28, 2025
382e060
grammar fix
quetzalliwrites Sep 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions src/content/docs/aws/capabilities/config/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -414,6 +414,7 @@ To learn more about these configuration options, see [Cloud Pods](/aws/capabilit
| `POD_LOAD_CLI_TIMEOUT` | 60 (default) | Timeout in seconds to wait before returning from load operations on the Cloud Pods CLI |
| `POD_ENCRYPTION` | `0` (default) \| `1` | Whether to encrypt the Cloud Pods artifacts at rest. |
| `ENABLE_POD_RESOURCES=1` | `0` (default) \| `1` | Whether to save a detailed Stack Overview including available resources for the Cloud Pod |
| `MERGE_STRATEGY` | `account-region-merge` (default) \| `service-merge` \| `overwrite` | The merge strategy to apply when loading a Cloud Pod into LocalStack (see [state merging](/aws/capabilities/state-management/cloud-pods/#state-merging)) |

## Extensions

Expand Down
5 changes: 4 additions & 1 deletion src/content/docs/aws/capabilities/state-management/cloud-pods.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -589,9 +589,12 @@ The available strategies are:
- `service-merge`: This strategy merges services at the account-region level, provided there's no overlap in resources.
It prioritizes the loaded resources when merging.

The LocalStack's default merge strategy can be changed via the `MERGE_STRATEGY` [configuration variable](/aws/capabilities/config/configuration/).

### LocalStack CLI

To activate merge strategies, set `--strategy <strategy>` when loading a Cloud Pod using the LocalStack CLI.
Every `pod load` operation uses the merge strategy set in `MERGE_STRATEGY` (`account-region-merge` by default).
When loading a Cloud Pod via the LocalStack CLI, set the `--strategy <strategy>` option to override the strategy in the configuration variable.
For instance, to load a Cloud Pod named `test-pod-s3-sqs` with the `service-merge` strategy, run the following command:

```bash
Expand Down