Version 1 of the AWS Cloud Development Kit (AWS CDK) is now in maintenance mode
AWS CDK v1 is no longer receiving higher-level “L2” construct updates for new or existing services. It will continue receiving updates for new and updated resource level “L1” constructs, critical bug fixes, and security updates only. We recommend you upgrade your applications to the new major version of CDK – AWS CDK version 2 (v2), which continues receiving new features and bug fixes.
On June 1, 2023, AWS CDK version 1 will reach the end-of-support.
After that, the AWS CDK v1 will no longer receive updates or releases. Previously published releases will continue to be available via public package managers and the code will remain on GitHub. Use of a CDK version which has reached end-of-support will be done at your own discretion.
AWS CDK v2 is a single package, making it easier for you to use the CDK and stay up-to-date with the new versions. AWS CDK v2 consolidates the AWS Construct Library into a single package called
aws-cdk-lib, and eliminates the need to download individual packages for each AWS service used. If you write your own CDK construct libraries, you only need to take a minimum dependency on this single package and let library consumers choose which AWS CDK version to use.
AWS CDK v2 only includes stable APIs, which comply with Semantic Versioning (semver), so you can confidently update to new minor versions. The CDK follows the “release early, release often” philosophy to encourage community participation, and we will continue deliver new features via experimental APIs for your feedback. Experimental modules will be distributed separately from
aws-cdk-lib, versioned clearly to show their pre-release status and will only be merged into
aws-cdk-lib when mature and stable.
Upgrading to AWS CDK v2 can be accomplished with a one-time safe re-bootstrapping of your AWS accounts and most projects only need to change
import statements. To learn more, refer to the following resources:
- Read “How customer feedback shaped the AWS Cloud Development Kit version 2” for more details.
- Learn about Migrating to CDK v2 in the CDK Developer Guide.
- Get started with the AWS CDK in all supported languages by taking CDK Workshop.
- Connect with the community in the cdk.dev Slack workspace.
- Follow our Contribution Guide to learn how to contribute fixes and features to the CDK.
- Open discussions or issues on GitHub if you have questions when migrating, or run into issues.