AWS CDK v1 から AWS CDK v2 への移行

npm install 、、または yarn install

npm install 、、または yarn install

python -m pip install -r requirements.txt

mvn package

dotnet restore

go get

アプリケーション

CDK アプリの場合は、package.json次のように更新します。v1 スタイルの個々の安定したモジュールへの依存関係を削除し、アプリケーションaws-cdk-libに必要な最低バージョンの を確立します (ここでは 2.0.0)。

実験コンストラクトは、 で終わる名前alphaとアルファバージョン番号を持つ個別の独立したバージョニングパッケージで提供されます。アルファバージョン番号は、互換性aws-cdk-libがある の最初のリリースに対応します。ここでは、 aws-codestarを v2.0.0-alpha.1 に固定しました。

{
  "dependencies": {
    "aws-cdk-lib": "^2.0.0",
    "@aws-cdk/aws-codestar-alpha": "2.0.0-alpha.1",
    "constructs": "^10.0.0"
  }
}

ライブラリの構築

コンストラクトライブラリaws-cdk-libの場合は、アプリケーションに必要な最低バージョンの を確立し (ここでは 2.0.0)package.json、次のように更新します。

は、ピア依存関係と dev 依存関係の両方としてaws-cdk-lib表示されることに注意してください。

{
  "peerDependencies": {
    "aws-cdk-lib": "^2.0.0",
    "constructs": "^10.0.0"
  },
  "devDependencies": {
    "aws-cdk-lib": "^2.0.0",
    "constructs": "^10.0.0",
    "typescript": "~3.9.0"
  }
}

ライブラリとアプリケーションの両方

npm install または を実行して、新しい依存関係をインストールしますyarn install。

インポートを変更して、新しいconstructsモジュールConstructからインポートしたり、 Appや などのコアタイプを の最上位レベルStackからインポートしたりaws-cdk-lib、 の名前空間から使用するサービスの安定した ライブラリモジュールを構築したりできますaws-cdk-lib。

import { Construct } from 'constructs';
import { App, Stack } from 'aws-cdk-lib';                 // core constructs
import { aws_s3 as s3 } from 'aws-cdk-lib';               // stable module
import * as codestar from '@aws-cdk/aws-codestar-alpha';  // experimental module

package.json 次のように更新します。v1 スタイルの個々の安定したモジュールへの依存関係を削除し、アプリケーションaws-cdk-libに必要な最低バージョンの を確立します (ここでは 2.0.0)。

実験コンストラクトは、 で終わる名前alphaとアルファバージョン番号を持つ個別の独立したバージョニングパッケージで提供されます。アルファバージョン番号は、互換性aws-cdk-libがある の最初のリリースに対応します。ここでは、 aws-codestarを v2.0.0-alpha.1 に固定しました。

{
  "dependencies": {
    "aws-cdk-lib": "^2.0.0",
    "@aws-cdk/aws-codestar-alpha": "2.0.0-alpha.1",
    "constructs": "^10.0.0"
  }
}

npm install または を実行して、新しい依存関係をインストールしますyarn install。

アプリのインポートを変更して、次の操作を行います。

const { Construct } = require('constructs');
const { App, Stack } = require('aws-cdk-lib');              // core constructs
const s3 = require('aws-cdk-lib').aws_s3;                   // stable module
const codestar = require('@aws-cdk/aws-codestar-alpha');    // experimental module

requirements.txt または install_requires 定義をsetup.py次のように更新します。v1 スタイルの個々の安定したモジュールへの依存関係を削除します。

実験コンストラクトは、 で終わる名前alphaとアルファバージョン番号を持つ個別の独立したバージョニングパッケージで提供されます。アルファバージョン番号は、互換性aws-cdk-libがある の最初のリリースに対応します。ここでは、 aws-codestarを v2.0.0alpha1 に固定しました。

install_requires=[
     "aws-cdk-lib>=2.0.0",
     "constructs>=10.0.0",
     "aws-cdk.aws-codestar-alpha>=2.0.0alpha1",
     # ...
],

アプリのインポートを変更して、次の操作を行います。

from constructs import Construct
from aws_cdk import App, Stack                    # core constructs
from aws_cdk import aws_s3 as s3                  # stable module
import aws_cdk.aws_codestar_alpha as codestar     # experimental module

# ...

class MyConstruct(Construct):
    # ...

class MyStack(Stack):
    # ...

s3.Bucket(...)

でpom.xml、安定したモジュールのsoftware.amazon.awscdk依存関係をすべて削除し、 software.constructs ( の場合Construct) と の依存関係に置き換えますsoftware.amazon.awscdk。

実験コンストラクトは、 で終わる名前alphaとアルファバージョン番号を持つ個別の独立したバージョニングパッケージで提供されます。アルファバージョン番号は、互換性aws-cdk-libがある の最初のリリースに対応します。ここでは、 aws-codestarを v2.0.0-alpha.1 に固定しました。

<dependency>
    <groupId>software.amazon.awscdk</groupId>
    <artifactId>aws-cdk-lib</artifactId>
    <version>2.0.0</version>
</dependency><dependency>
    <groupId>software.amazon.awscdk</groupId>
    <artifactId>code-star-alpha</artifactId>
    <version>2.0.0-alpha.1</version>
</dependency>
<dependency>
    <groupId>software.constructs</groupId>
    <artifactId>constructs</artifactId>
    <version>10.0.0</version>
</dependency>

を実行して、新しい依存関係をインストールしますmvn package。

コードを変更して、次の操作を行います。

import software.constructs.Construct;
import software.amazon.awscdk.Stack;
import software.amazon.awscdk.StackProps;
import software.amazon.awscdk.App;
import software.amazon.awscdk.services.s3.Bucket;
import software.amazon.awscdk.services.codestar.alpha.GitHubRepository;

C# CDKアプリケーションの依存関係をアップグレードする最も簡単な方法は、.csprojファイルを手動で編集することです。安定したAmazon.CDK.*パッケージリファレンスをすべて削除し、 Amazon.CDK.Libおよび Constructsパッケージへのリファレンスに置き換えます。

実験コンストラクトは、 で終わる名前alphaとアルファバージョン番号を持つ個別の独立したバージョニングパッケージで提供されます。アルファバージョン番号は、互換性aws-cdk-libがある の最初のリリースに対応します。ここでは、 aws-codestarを v2.0.0-alpha.1 に固定しました。

<PackageReference Include="Amazon.CDK.Lib" Version="2.0.0" />
<PackageReference Include="Amazon.CDK.AWS.Codestar.Alpha" Version="2.0.0-alpha.1" />
<PackageReference Include="Constructs" Version="10.0.0" />

を実行して、新しい依存関係をインストールしますdotnet restore。

ソースファイルのインポートを次のように変更します。

using Constructs;                   // for Construct class
using Amazon.CDK;                   // for core classes like App and Stack
using Amazon.CDK.AWS.S3;            // for stable constructs like Bucket
using Amazon.CDK.Codestar.Alpha;    // for experimental constructs

依存関係を最新バージョンに更新し、プロジェクトの .mod ファイルを更新するgo get問題。