Skip to content
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.

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

Docs: Add info on what "cdk bootstrap" creates. #1812

Closed
Doug-AWS opened this issue Feb 20, 2019 · 10 comments
Closed

Docs: Add info on what "cdk bootstrap" creates. #1812

Doug-AWS opened this issue Feb 20, 2019 · 10 comments
Assignees
Labels
docs/guide Related to the developer guide effort/small Small work item – less than a day of effort p2 pr/work-in-progress This PR is a draft and needs further work.

Comments

@Doug-AWS
Copy link
Contributor

  • Is the user on the hook for any costs?
  • What do we create for them?
  • Do we have a list?
  • If they decide to no longer use the CDK, how do they delete these resources?
@Doug-AWS Doug-AWS added documentation p2 effort/small Small work item – less than a day of effort docs/guide Related to the developer guide labels Feb 20, 2019
@Doug-AWS Doug-AWS self-assigned this Feb 20, 2019
@rix0rrr
Copy link
Contributor

rix0rrr commented Feb 21, 2019

Do you need this info, or are these notes for yourself?

@Doug-AWS
Copy link
Contributor Author

I need the info, hence the "needs contributors" label.

@rix0rrr
Copy link
Contributor

rix0rrr commented Feb 21, 2019

Here's what we create:

https://github.com/awslabs/aws-cdk/blob/master/packages/aws-cdk/lib/api/bootstrap-environment.ts#L14

Today it's a Bucket. They pay for what's in there. We don't clean it currently, so it accumulates.

In the future, we'll probably add ECR repositories. They will pay for what's in there as well.

In the future, we'll probably add a Lambda function that executes on a schedule. They will pay for the executions, but the Lambda function's gonna clean up unused resources, so that should save them some money.

They get rid of it by deleting the CDKToolkit stack from their account.

@Doug-AWS
Copy link
Contributor Author

Thanks. I'll create a draft soon and send it out for review.

@Doug-AWS
Copy link
Contributor Author

Doug-AWS commented Feb 21, 2019

Here's what I have so far:

Bootstrapping the CDK

Before you can use the CDK you must bootstrap the CDK to create the infrastructure that the CDK needs. Currently the bootstrap command creates only an Amazon S3 bucket.

You incur any charges for what the CDK stores in the bucket. Because the CDK does not remove any objects from the bucket, the bucket can accumulate objects as you use the CDK. You can get rid of the bucket by deleting the CDKToolkit stack from your account.

@Doug-AWS Doug-AWS added the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Feb 21, 2019
@rix0rrr
Copy link
Contributor

rix0rrr commented Feb 22, 2019

Yep, good for now.

@rix0rrr
Copy link
Contributor

rix0rrr commented Feb 22, 2019

The part about it that I don't like is that it will just invite more questions. But I guess those are the ways.

@Doug-AWS
Copy link
Contributor Author

Yep, opening Pandora's box.

@Doug-AWS Doug-AWS added pr/work-in-progress This PR is a draft and needs further work. and removed pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. labels Feb 22, 2019
@Doug-AWS
Copy link
Contributor Author

@Dzhuneyt
Copy link
Contributor

Dzhuneyt commented Jan 8, 2020

What about adding a cdk bootstrap --destroy possibility (#986 (comment))? I think it would be much more intuitive than having to delete the CloudFormation stack from the AWS console.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs/guide Related to the developer guide effort/small Small work item – less than a day of effort p2 pr/work-in-progress This PR is a draft and needs further work.
Projects
None yet
Development

No branches or pull requests

3 participants