Migrieren von AWS CDK v1 zu AWS CDK v2

npm install oder yarn install

npm install oder yarn install

python -m pip install -r requirements.txt

mvn package

dotnet restore

go get

Anwendungen

Aktualisieren Sie für CDK-Apps package.json wie folgt. Entfernen Sie Abhängigkeiten von einzelnen stabilen Modulen im v1-Stil und legen Sie die niedrigste Version von fest, die aws-cdk-lib Sie für Ihre Anwendung benötigen (hier 2.0.0).

Experimentelle Konstrukte werden in separaten, unabhängig versionierten Paketen mit Namen bereitgestellt, die mit enden, alpha und einer Alpha-Versionsnummer. Die Alpha-Versionsnummer entspricht der ersten Version von , aws-cdk-lib mit der sie kompatibel sind. Hier haben wir aws-codestar auf v2.0.0-alpha.1 angeheftet.

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

Bibliotheken erstellen

Richten Sie für Konstruktbibliotheken die niedrigste Version von ein, die aws-cdk-lib Sie für Ihre Anwendung benötigen (hier 2.0.0), und aktualisieren Sie package.json wie folgt.

Beachten Sie, dass sowohl als Peer-Abhängigkeit als auch als Entwicklungsabhängigkeit aws-cdk-lib angezeigt wird.

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

Sowohl Bibliotheken als auch Apps

Installieren Sie die neuen Abhängigkeiten, indem Sie npm install oder ausführenyarn install.

Ändern Sie Ihre Importe, um sie Construct aus dem neuen constructs Modul, Kerntypen wie App und Stack von der obersten Ebene von zu importieren, und stabile Module der Construct Library für die Servicesaws-cdk-lib, die Sie aus Namespaces unter verwendenaws-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

Aktualisieren Sie package.json wie folgt. Entfernen Sie Abhängigkeiten von einzelnen stabilen Modulen im v1-Stil und legen Sie die niedrigste Version von fest, die aws-cdk-lib Sie für Ihre Anwendung benötigen (hier 2.0.0).

Experimentelle Konstrukte werden in separaten, unabhängig versionierten Paketen mit Namen bereitgestellt, die mit enden, alpha und einer Alpha-Versionsnummer. Die Alpha-Versionsnummer entspricht der ersten Version von , aws-cdk-lib mit der sie kompatibel sind. Hier haben wir aws-codestar auf v2.0.0-alpha.1 angeheftet.

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

Installieren Sie die neuen Abhängigkeiten, indem Sie npm install oder ausführenyarn install.

Ändern Sie die Importe Ihrer App, um Folgendes zu tun:

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

Aktualisieren Sie requirements.txt oder die install_requires Definition in setup.py wie folgt. Entfernen Sie Abhängigkeiten von einzelnen stabilen Modulen im v1-Stil.

Experimentelle Konstrukte werden in separaten, unabhängig versionierten Paketen mit Namen bereitgestellt, die mit enden, alpha und einer Alpha-Versionsnummer. Die Alpha-Versionsnummer entspricht der ersten Version von , aws-cdk-lib mit der sie kompatibel sind. Hier haben wir aws-codestar auf v2.0.0alpha1 angeheftet.

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

Ändern Sie die Importe Ihrer App, um Folgendes zu tun:

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

Entfernen Sie pom.xmlin alle software.amazon.awscdk Abhängigkeiten für stabile Module und ersetzen Sie sie durch Abhängigkeiten von software.constructs (für Construct) und software.amazon.awscdk.

Experimentelle Konstrukte werden in separaten, unabhängig versionierten Paketen mit Namen bereitgestellt, die mit enden, alpha und einer Alpha-Versionsnummer. Die Alpha-Versionsnummer entspricht der ersten Version von , aws-cdk-lib mit der sie kompatibel sind. Hier haben wir aws-codestar auf v2.0.0-alpha.1 angeheftet.

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

Installieren Sie die neuen Abhängigkeiten, indem Sie ausführenmvn package.

Ändern Sie Ihren Code, um Folgendes zu tun:

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;

Die einfachste Möglichkeit, die Abhängigkeiten einer C#-CDK-Anwendung zu aktualisieren, besteht darin, die .csproj Datei manuell zu bearbeiten. Entfernen Sie alle stabilen Amazon.CDK.* Paketreferenzen und ersetzen Sie sie durch Verweise auf die Constructs Pakete Amazon.CDK.Lib und .

Experimentelle Konstrukte werden in separaten, unabhängig versionierten Paketen mit Namen bereitgestellt, die mit enden, alpha und einer Alpha-Versionsnummer. Die Alpha-Versionsnummer entspricht der ersten Version von , aws-cdk-lib mit der sie kompatibel sind. Hier haben wir aws-codestar auf v2.0.0-alpha.1 angeheftet.

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

Installieren Sie die neuen Abhängigkeiten, indem Sie ausführendotnet restore.

Ändern Sie die Importe in Ihren Quelldateien wie folgt.

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

Geben Sie eingo get, um Ihre Abhängigkeiten auf die neueste Version zu aktualisieren, und aktualisieren Sie die -.modDatei Ihres Projekts.