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

Applications

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"
  }
}

Construct 라이브러리

Construct 라이브러리의 경우 애플리케이션에 필요한 aws-cdk-lib의 최저 버전(여기서 2.0.0)을 설정하고 다음과 같이 package.json을 업데이트합니다.

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를 가져오고, aws-cdk-lib의 최상위 수준에서 App, Stack 등의 핵심 유형을 가져오고, aws-cdk-lib 아래의 네임스페이스에서 사용하는 서비스에 대한 안정적인 construct 라이브러리 모듈을 가져옵니다.

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

다음과 같이 setup.py 에서 requirements.txt 또는 install_requires 정의를 업데이트합니다. 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

go get을 실행하여 종속성을 최신 버전으로 업데이트하고 프로젝트의 .mod 파일을 업데이트합니다.