从 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 和 alpha 版本号为结尾。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。

请注意，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 下的命名空间导入您所用服务的稳定构造库模块。

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 和 alpha 版本号为结尾。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 或 setup.py 中的 install_requires 定义。删除 v1 风格的单个稳定模块的依赖项。

实验性构造在单独的、独立版本控制的软件包中提供，其名称以 alpha 和 alpha 版本号为结尾。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 和 alpha 版本号为结尾。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 和 alpha 版本号为结尾。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 文件。