ref. AWS CDKv2 への移行

CDK v1 は 2023 年 6 月 1 日にサポートが終了している。このドキュメントは、v1 から v2 へ移行する際の記録として残している。

変更点

  • コンストラクタライブラリをaws-cdk-libに統合
  • 新しいものはまず@aws-cdk/aws-xxxxx-alphaとして配布されて、安定したらaws-cdk-libに統合
  • Constructクラスは関連する型とともにAWS CDKからconstructsライブラリに移動（AWS CDKから独立）

※ aws-cdk-libはaws/aws-cdkの一部。constructsはaws/aws-cdkから独立。

ステップ

最も安全なアップグレード体験を実現し、予期しない変更のソースをより簡単に診断するために、2つのステップを分離して進めることをお勧めします。まず、最新のv1バージョンにアップグレードし、その後にv2に切り替えてください。

ref. https://docs.aws.amazon.com/ja_jp/cdk/v2/guide/migrating-v2.html

移行中

移行中は、プロジェクトごとにバージョンを固定する必要がある。 そのため、ライブラリ（aws-cdk-lib）だけでなく、CLI（aws-cdk）もプロジェクトにインストールして、npx cdk で実行する。

AWS CDK 開発の基礎 の CLI のグローバルインストールは、移行が完了したあとの新規プロジェクトの前提である。