Migrando da AWS CDK v1 para a v2 AWS CDK

npm install ou yarn install

npm install ou yarn install

python -m pip install -r requirements.txt

mvn package

dotnet restore

go get

Aplicações

Para aplicações CDK, atualize package.json da seguinte forma. Remova as dependências dos módulos estáveis individuais no estilo v1 e estabeleça a versão mais baixa de aws-cdk-lib que você precisa para sua aplicação (2.0.0 aqui).

Construtos experimentais são fornecidos em pacotes separados, com versões independentes, com nomes que terminam em alpha e um número de versão alfa. O número da versão alfa corresponde à primeira versão de aws-cdk-lib com a qual são compatíveis. Aqui, fixamos aws-codestar para 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"
  }
}

Bibliotecas de constructos

Para bibliotecas de constructos, estabeleça a versão mais baixa de aws-cdk-lib que você precisa para sua aplicação (2.0.0 aqui) e atualize package.json da seguinte forma.

Observe que aws-cdk-lib aparece tanto como uma dependência de pares quanto como uma dependência de desenvolvimento.

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

Bibliotecas e aplicações

Instale as novas dependências executando npm install ou yarn install.

Altere suas importações para importar Construct do novo módulo constructs, tipos principais, como App e Stack do nível superior de aws-cdk-lib, e módulos estáveis da Biblioteca de Constructos para os serviços que você usa dos namespaces abaixo. 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

Atualize package.json da seguinte forma. Remova as dependências dos módulos estáveis individuais no estilo v1 e estabeleça a versão mais baixa de aws-cdk-lib que você precisa para sua aplicação (2.0.0 aqui).

Construtos experimentais são fornecidos em pacotes separados, com versões independentes, com nomes que terminam em alpha e um número de versão alfa. O número da versão alfa corresponde à primeira versão de aws-cdk-lib com a qual são compatíveis. Aqui, fixamos aws-codestar para 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"
  }
}

Instale as novas dependências executando npm install ou yarn install.

Altere as importações da sua aplicação para fazer o seguinte:

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

Atualize requirements.txt ou a definição de install_requires em setup.py da seguinte forma. Remova as dependências dos módulos estáveis individuais no estilo v1.

Construtos experimentais são fornecidos em pacotes separados, com versões independentes, com nomes que terminam em alpha e um número de versão alfa. O número da versão alfa corresponde à primeira versão de aws-cdk-lib com a qual são compatíveis. Aqui, fixamos aws-codestar para v2.0.0alpha1.

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

Altere as importações da sua aplicação para fazer o seguinte:

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(...)

Em pom.xml, remova todas as dependências software.amazon.awscdk dos módulos estáveis e substitua-as por dependências em software.constructs (para Construct) e software.amazon.awscdk.

Construtos experimentais são fornecidos em pacotes separados, com versões independentes, com nomes que terminam em alpha e um número de versão alfa. O número da versão alfa corresponde à primeira versão de aws-cdk-lib com a qual são compatíveis. Aqui, fixamos aws-codestar para 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>

Instale as novas dependências executando mvn package.

Altere seu código para fazer o seguinte:

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;

A maneira mais simples de atualizar as dependências de uma aplicação CDK em C# é editar o arquivo .csproj manualmente. Remova todas as referências de pacotes Amazon.CDK.* estáveis e substitua-as por referências aos pacotes Amazon.CDK.Lib e Constructs.

Construtos experimentais são fornecidos em pacotes separados, com versões independentes, com nomes que terminam em alpha e um número de versão alfa. O número da versão alfa corresponde à primeira versão de aws-cdk-lib com a qual são compatíveis. Aqui, fixamos aws-codestar para 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" />

Instale as novas dependências executando dotnet restore.

Altere as importações em seus arquivos de origem da seguinte maneira.

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

Emita go get para atualizar suas dependências para a versão mais recente e atualizar o arquivo .mod do seu projeto.