Dies ist der AWS CDK v2-Entwicklerhandbuch. Das ältere CDK v1 wurde am 1. Juni 2022 in die Wartung aufgenommen und der Support wurde am 1. Juni 2023 eingestellt.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Der AWS CDK verwendet Feature-Flags, um potenziell fehlerhafte Verhaltensweisen in einer Version zu aktivieren. Flags werden als Kontextwerte und AWS CDK Werte in cdk.json (oder~/.cdk.json) gespeichert. Sie werden nicht durch die cdk context --clear Befehle cdk context --reset oder entfernt.
Feature-Flags sind standardmäßig deaktiviert. Bestehende Projekte, bei denen das Flag nicht angegeben ist, funktionieren mit späteren AWS CDK Versionen weiterhin wie zuvor. Neue Projekte, die mithilfe von cdk init Include-Flags erstellt wurden, aktivieren alle Funktionen, die in der Version verfügbar waren, mit der das Projekt erstellt wurde. Bearbeiten Siecdk.json, um alle Flags zu deaktivieren, für die Sie das frühere Verhalten bevorzugen. Sie können auch Flags hinzufügen, um nach dem Upgrade von neue Verhaltensweisen zu aktivieren AWS CDK.
Eine Liste aller aktuellen Feature-Flags finden Sie im AWS CDK GitHub Repository unter FEATURE_FLAGS.mdCHANGELOG in dieser Version hinzugefügt wurden, finden Sie in einer bestimmten Version.
Rückkehr zum Verhalten von Version 1
In CDK v2 wurden die Standardeinstellungen für einige Feature-Flags gegenüber Version 1 geändert. Sie können diese wieder auf setzen, um false zu einem bestimmten AWS CDK v1-Verhalten zurückzukehren. Verwenden Sie den cdk diff Befehl, um die Änderungen an Ihrer synthetisierten Vorlage zu überprüfen und festzustellen, ob eines dieser Flags benötigt wird.
@aws-cdk/core:newStyleStackSynthesis-
Verwenden Sie die neue Stack-Synthesemethode, die Bootstrap-Ressourcen mit bekannten Namen voraussetzt. Erfordert modernes Bootstrapping, ermöglicht aber wiederum CI/CD über CDK Pipelines und kontenübergreifende Bereitstellungen von Haus aus.
@aws-cdk/aws-apigateway:usagePlanKeyOrderInsensitiveId-
Wenn Ihre Anwendung mehrere Amazon API Gateway Gateway-API-Schlüssel verwendet und diese mit Nutzungsplänen verknüpft.
@aws-cdk/aws-rds:lowercaseDbIdentifier-
Wenn Ihre Anwendung Amazon RDS-Datenbank-Instances oder Datenbankcluster verwendet und die ID für diese explizit angibt.
@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021-
Wenn Ihre Anwendung die Sicherheitsrichtlinie TLS_V1_2_2019 für Distributionen verwendet. Amazon CloudFront CDK v2 verwendet standardmäßig die Sicherheitsrichtlinie 2.2_2021. TLSv1
@aws-cdk/core:stackRelativeExports-
Wenn Ihre Anwendung mehrere Stacks verwendet und Sie auf Ressourcen von einem Stack in einem anderen verweisen, bestimmt dies, ob für die Erstellung von Exporten ein absoluter oder relativer Pfad verwendet wird. AWS CloudFormation
@aws-cdk/aws-lambda:recognizeVersionProps-
Wenn auf gesetzt
false, bezieht das CDK Metadaten mit ein, wenn es erkennt, ob sich eine Lambda-Funktion geändert hat. Dies kann zu Bereitstellungsfehlern führen, wenn nur die Metadaten geändert wurden, da doppelte Versionen nicht zulässig sind. Sie müssen dieses Flag nicht rückgängig machen, wenn Sie mindestens eine Änderung an allen Lambda-Funktionen in Ihrer Anwendung vorgenommen haben.
Die Syntax für das Zurücksetzen dieser Flags cdk.json wird hier gezeigt.
{
"context": {
"@aws-cdk/core:newStyleStackSynthesis": false,
"@aws-cdk/aws-apigateway:usagePlanKeyOrderInsensitiveId": false,
"@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021": false,
"@aws-cdk/aws-rds:lowercaseDbIdentifier": false,
"@aws-cdk/core:stackRelativeExports": false,
"@aws-cdk/aws-lambda:recognizeVersionProps": false
}
}