Administration
Delete your Gitpod installation
If you need to delete your Gitpod installation, this guide will show you
how.
This is useful in case you no longer need your Gitpod installation, or if you need to re-run the CloudFormation installation process.Unfortunately, this is not as easy as just deleting the CloudFormation Stack in AWS, because CloudFormation creates some resources that it cannot delete itself (for example, CloudWatch log groups)
Disclaimer: By design,
cloud-nuke will completely and
permanently delete all the resources present in your AWS sub-account. This
is highly destructive. Please use with extreme caution.
1. Delete resources in the AWS account of the Enterprise instance
1. Delete resources in the AWS account of the Enterprise instance
-
Delete the CloudFormation stack of the Gitpod installation
When deleting failed CloudFormation stacks, sometimes the delete will fail because of a particular resource. When you try to delete the stack again, it will warn you which resources it failed on with a link to the resource. Click those links and manually delete them via the UI, then re-trigger the stack delete. It may give you an option to ignore those resources that failed previously, this time check all of those and the stack delete should succeed. If the
lambdacellstatecontrollersuborlambdacellstatecontrollertriggerresources get stuck (CREATE_IN_PROGRESS status for over an hour), then reach out to Gitpod Support. - Delete the CloudFormation stack used to create the role used to execute the Gitpod CloudFormation template
2. Delete any residual resources in the AWS account using cloud-nuke
2. Delete any residual resources in the AWS account using cloud-nuke
- Install cloud-nuke
- Ensure the user or role active in your AWS CLI has access to the AWS Account where Gitpod is installed into
-
Run cloud-nuke on the account:
cloud-nuke aws --exclude-resource-type transit-gateway- The
transit-gatewayresource type is excluded because the transit gateway is shared between accounts, so this is necessary to not delete the transit gateway in the other AWS Account - assuming that Transit Gateway is used for other purposes as well. - You can also add the
--region us-east-2,globalflags to greatly speed up the cloud-nuke, but sometimes you will need to check all regions to ensure all resources are deleted.
- The