AWS CDK Feature-Flaggen - AWS Cloud Development Kit (AWS CDK) v2
Rückkehr zum Verhalten von Version 1

Dies ist der AWS CDK v2-Entwicklerhandbuch. Die ältere CDK Version 1 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.

AWS CDK Feature-Flaggen

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.md. Eine Beschreibung aller neuen Feature-Flags, die CHANGELOG in dieser Version hinzugefügt wurden, finden Sie in einer bestimmten Version.

Rückkehr zum Verhalten von Version 1

In CDK Version 2 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 CDKPipelines und kontenübergreifende Bereitstellungen, die sofort einsatzbereit sind.

@aws-cdk/aws-apigateway:usagePlanKeyOrderInsensitiveId

Wenn Ihre Anwendung mehrere Amazon API API Gateway-Schlüssel verwendet und diese Nutzungsplänen zuordnet.

@aws-cdk/aws-rds:lowercaseDbIdentifier

Wenn Ihre Anwendung RDS Amazon-Datenbank-Instances oder Datenbank-Cluster verwendet und die Kennung 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 CDKv2 verwendet standardmäßig die Sicherheitsrichtlinie .2_2021TLSv1.

@aws-cdk/core:stackRelativeExports

Wenn Ihre Anwendung mehrere Stapel verwendet und Sie auf Ressourcen von einem Stapel 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 gesetztfalse, CDK schließt das Metadaten ein, wenn erkannt wird, 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
  }
}