aws / aws-cdk

The AWS Cloud Development Kit is a framework for defining cloud infrastructure in code
https://aws.amazon.com/cdk
Apache License 2.0
11.68k stars 3.93k forks source link

(aws-cdk-lib): Better Document Stages #28312

Open RichiCoder1 opened 11 months ago

RichiCoder1 commented 11 months ago

Describe the issue

A common concept in a lot of recent frameworks in the concept of "Stacks" or "Stages" as discreet environment-specific configurations of Stacks.

The CDK even has the concept of Stages, but it's largely relegated to documenting it's usage in the context of CDK Pipelines.

I'd love to see the documentation expanded to describe how one would use stages in a manner similar to Serverless Framework, SST, or Pulumi Stacks, and how to deploy specific stages via the CLI without using pipelines.

Links

https://docs.aws.amazon.com/cdk/v2/guide/stacks.html https://docs.aws.amazon.com/cdk/v2/guide/environments.html

khushail commented 11 months ago

Hi @RichiCoder1 , thanks for reaching out. Here is some explanation of the related topic but it would be really great to have detailed documentation as well. Marking this as P2.