Migrazione dalla AWS CDK v1 alla v2 AWS CDK

npm install o yarn install

npm install o yarn install

python -m pip install -r requirements.txt

mvn package

dotnet restore

go get

Applicazioni

Per le app CDK, esegui l'aggiornamento package.json come segue. Rimuovi le dipendenze dai singoli moduli stabili in stile v1 e stabilisci la versione più bassa richiesta per la tua applicazione (2.0.0 qui). aws-cdk-lib

I costrutti sperimentali sono forniti in pacchetti separati, con versioni indipendenti, con nomi che terminano con e un numero di versione alfa. alpha Il numero di versione alpha corrisponde alla prima versione aws-cdk-lib con cui sono compatibili. Qui, abbiamo aggiunto la versione 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"
  }
}

Costruisci librerie

Per le librerie di costruzione, stabilisci la versione più bassa richiesta per la tua applicazione (2.0.0 qui) e aggiorna come segue. aws-cdk-lib package.json

Nota che aws-cdk-lib appare sia come dipendenza tra pari che come dipendenza di sviluppo.

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

Librerie e app

Installa le nuove dipendenze eseguendo npm install oyarn install.

Modificate le importazioni in modo Construct da importare dal nuovo constructs modulo i tipi principali (ad esempio App e Stack dal livello superiore diaws-cdk-lib) e i moduli stabili di Construct Library per i servizi utilizzati dai namespace sottostanti. 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

Aggiorna come segue. package.json Rimuovi le dipendenze dai singoli moduli stabili in stile v1 e stabilisci la versione più bassa richiesta per la tua applicazione (2.0.0 qui). aws-cdk-lib

I costrutti sperimentali sono forniti in pacchetti separati, con versioni indipendenti, con nomi che terminano con e un numero di versione alfa. alpha Il numero di versione alpha corrisponde alla prima versione aws-cdk-lib con cui sono compatibili. Qui, abbiamo aggiunto la versione 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"
  }
}

Installa le nuove dipendenze eseguendo o. npm install yarn install

Modifica le importazioni dell'app per effettuare le seguenti operazioni:

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

Aggiorna requirements.txt la install_requires definizione come segue. setup.py Rimuovi le dipendenze dai singoli moduli stabili in stile v1.

I costrutti sperimentali sono forniti in pacchetti separati, con versioni indipendenti, con nomi che terminano con alpha e un numero di versione alfa. Il numero di versione alpha corrisponde alla prima versione aws-cdk-lib con cui sono compatibili. Qui, abbiamo bloccato la versione 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",
     # ...
],

Modifica le importazioni dell'app per effettuare le seguenti operazioni:

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

Inpom.xml, rimuovi tutte le software.amazon.awscdk dipendenze per i moduli stabili e sostituiscile con dipendenze da (for) e. software.constructs Construct software.amazon.awscdk

I costrutti sperimentali sono forniti in pacchetti separati, con versioni indipendenti, con nomi che terminano con alpha e un numero di versione alfa. Il numero di versione alpha corrisponde alla prima versione aws-cdk-lib con cui sono compatibili. Qui, abbiamo aggiunto la versione 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>

Installa le nuove dipendenze eseguendo. mvn package

Modifica il codice per eseguire le seguenti operazioni:

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;

Il modo più semplice per aggiornare le dipendenze di un'applicazione C# CDK consiste nel modificare il file manualmente. .csproj Rimuovi tutti i riferimenti stabili ai Amazon.CDK.* pacchetti e sostituiscili con riferimenti ai pacchetti and. Amazon.CDK.Lib Constructs

I costrutti sperimentali sono forniti in pacchetti separati, con versioni indipendenti, con nomi che terminano con alpha e un numero di versione alfa. Il numero di versione alpha corrisponde alla prima versione aws-cdk-lib con cui sono compatibili. Qui, abbiamo aggiunto la versione 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" />

Installa le nuove dipendenze eseguendo. dotnet restore

Modifica le importazioni nei tuoi file sorgente come segue.

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

Problema go get per aggiornare le dipendenze alla versione più recente e aggiornare il .mod file del progetto.