Skip to content

Commit 96c24fd

Browse files
authored
chore(documentation): Update known issues for ASEAResources.json (#1289)
* chore(documentation): update known issues with asearesources issue
1 parent 088d882 commit 96c24fd

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

src/mkdocs/docs/lza-upgrade/known-issues.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,17 @@ cat network-config.yaml | yq '[.vpcs[] | select(.account == "shared-network" and
5757

5858
**If the sum of those three type of resources is above 380 in a single account and region, further investigation is recommended before attempting the upgrade.**
5959

60+
### ASEAResources.json Synchronization Issue
61+
62+
**Description:** In certain circumstances during the upgrade process, the LZA Pipeline may fail with `<resource name>` already exists in stack `<stack id>`. This error occurs because of inconsistencies with the resource mappings and the current state of the CloudFormation deployed by the LZA. To resolve this issue, the LZA pipeline can be re-run from the beginning to synchronize resource mappings If the issue still persists after the pipeline has been re-run, please contact AWS support.
63+
64+
**Root cause:** The synchronization issue stems from the following sequential processing order in the LZA pipeline:
65+
1. Stack synthesis occurs before the completion of the import ASEA resources stage (in the bootstrap stage)
66+
2. The aseaResources.json file is not written until *after* stack synthesis
67+
3. Consequently, synthesized stacks do not reflect resource modifications (additions or removals) made during the import ASEA resources stage
68+
69+
**Resolution or workaround:** If resource synchronization issues are encountered, executing the LZA pipeline can be re-run from the beginning to synchronize resource mappings.
70+
6071
## Landing Zone Accelerator known issues
6172
The following issues will not prevent a successful upgrade from ASEA to LZA, but can impact functionalities and operations in the upgraded Landing Zone.
6273

0 commit comments

Comments
 (0)