aws-amplify / aws-amplify/docs

Documentation lacking how to handle scenario for pre-bootstrapped environments...

Open
#7,482 3 comments 2 reactions 0 assignees View on GitHub
amplify/cli amplify/gen2 p3
Dominant language
MDX
Stars
506
Forks
1.1k
Avg merge
3h 14m
Merged PRs (30d)
1

Description

**[Amplify Docs - Bootstrap your AWS account](https://docs.amplify.aws/react/start/account-setup/#5-bootstrap-your-aws-account)**

The documentation doesn't provide information on the error that will present in the console if the AWS account already has a CDKToolkit: `Stack [CDKToolkit] already exists`

If the account was bootstrapped previously, the option to initiate the first-time setup does not appear when going through the steps to create an Amplify application. The option does not appear before clicking through to create the new app, which then leads to the `Stack [CDKToolkit] already exists` error.

I found that [this GitHub issue](https://github.com/aws-amplify/amplify-backend/issues/777#issuecomment-1842088587) provides a solution to move past this error. You can open Cloudshell and run `cdk bootstrap aws://ACCOUNT-NUMBER-1/REGION-1`to update the bootstrap stack to a new version. Once this is done, the error no longer appears, and the app creates successfully.

I think it would benefit users of the Amplify service to have a section in the documentation that mentions this error and how to move past it.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.