AWS Developer Tools Blog

Version 1 of the AWS Cloud Development Kit (AWS CDK) is now in maintenance mode

The AWS Cloud Development Kit (AWS CDK) version 1 (v1) for JavaScript, TypeScript, Java, Python, .NET and Go 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:

 

Author:

 Rico Huijbers

Rico is a senior engineer in on the AWS CDK team.