Migration von AWS CDK v1 zu v2 AWS CDK

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 CDK-Apps package.json wie folgt. Entfernen Sie Abhängigkeiten von einzelnen stabilen Modulen im v1-Stil und richten Sie die niedrigste Version ein, die aws-cdk-lib Sie für Ihre Anwendung benötigen (2.0.0 hier).

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

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

Konstruieren Sie Bibliotheken

Stellen Sie für Construct-Bibliotheken die niedrigste Version fest, die aws-cdk-lib Sie für Ihre Anwendung benötigen (2.0.0 hier), und aktualisieren Sie package.json sie wie folgt.

Beachten Sie, dass dies sowohl als Peer-Abhängigkeit als auch als Dev-Abhängigkeit aws-cdk-lib erscheint.

{
  "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 so, dass sie Construct aus dem neuen constructs Modul, Kerntypen wie App und Stack aus der obersten Ebene von und stabilen Construct-Library-Modulen für die Diensteaws-cdk-lib, die Sie aus den Namespaces unter verwenden, importieren. 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

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

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

{
  "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 oder ausführen. npm install yarn install

Ändern Sie die Importe Ihrer App wie folgt:

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 die install_requires Definition wie folgt. setup.py Entfernen Sie Abhängigkeiten von einzelnen stabilen Modulen im v1-Stil.

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

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 wie folgt:

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 unter alle software.amazon.awscdk Abhängigkeiten für stabile Module und ersetzen Sie sie durch Abhängigkeiten von software.constructs (fürConstruct) und. pom.xml software.amazon.awscdk

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

<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 Folgendes ausführen. mvn package

Ändern Sie Ihren Code so, dass er wie folgt funktioniert:

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 Methode, die Abhängigkeiten einer C#-CDK-Anwendung zu aktualisieren, besteht darin, die .csproj Datei manuell zu bearbeiten. Entfernen Sie alle stabilen Amazon.CDK.* Paketverweise und ersetzen Sie sie durch Verweise auf die Pakete Amazon.CDK.Lib undConstructs.

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

<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 Folgendes ausführen. dotnet 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

Problemgo get, um Ihre Abhängigkeiten auf die neueste Version zu aktualisieren und die .mod Datei Ihres Projekts zu aktualisieren.