Dies ist der AWS CDK v2-Entwicklerhandbuch. Das ältere CDK v1 wurde am 1. Juni 2022 gewartet 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 Versioning

Dieses Thema enthält Referenzinformationen darüber, wie das Versioning AWS Cloud Development Kit (AWS CDK) verarbeitet.

Versionsnummern bestehen aus drei numerischen Versionsteilen: Hauptversion.Nebenversion.Patch und halten sich strikt an das semantische Versioning-Modell. Das bedeutet, dass grundlegende Änderungen an stabilen APIs auf Hauptversionen beschränkt sind.

Neben- und Patch-Versionen sind abwärtskompatibel. Der in einer früheren Version mit derselben Hauptversion geschriebene Code kann auf eine neuere Version innerhalb derselben Hauptversion aktualisiert werden. Es wird auch weiterhin erstellt und ausgeführt, was dieselbe Ausgabe erzeugt.

AWS CDKCLI Kompatibilität

Die AWS CDK CLI ist immer mit Konstruktbibliotheken einer semantisch niedrigeren oder gleichen Versionsnummer kompatibel. Daher ist es immer sicher, das AWS CDK CLI innerhalb derselben Hauptversion zu aktualisieren.

Die AWS CDK CLI ist nicht immer mit Konstruktbibliotheken einer semantisch höheren Version kompatibel. Kompatibilität hängt davon ab, ob dieselbe Cloud-Assembly-Schemaversion von den beiden Komponenten eingesetzt wird. Das AWS CDK Framework generiert während der Synthetisierung eine Cloud-Baugruppe und die AWS CDK CLI verbraucht sie für die Bereitstellung. Das Schema, das das Format der Cloud-Baugruppe definiert, wird streng angegeben und versioniert.

AWS -Konstruktbibliotheken, die eine bestimmte Cloud-Assembly-Schemaversion verwenden, sind mit AWS CDK CLI Versionen kompatibel, die diese Schemaversion oder höher verwenden. Dies kann Releases des AWS CDK CLI enthalten, die älter als eine bestimmte Konstruktbibliotheksversion sind.

Wenn die für die Konstruktbibliothek erforderliche Cloud-Assembly-Version nicht mit der von unterstützten Version kompatibel ist AWS CDK CLI, erhalten Sie eine Fehlermeldung wie die folgende:

Cloud assembly schema version mismatch: Maximum schema version supported is 3.0.0, but found 4.0.0.
    Please upgrade your CLI in order to interact with this app.

Um diesen Fehler zu beheben, aktualisieren Sie auf AWS CDK CLI eine Version, die mit der erforderlichen Cloud-Assembly-Version kompatibel ist, oder auf die neueste verfügbare Version. Die Alternative (Herunterstufen der Konstruktbibliotheksmodule, die Ihre App verwendet) wird im Allgemeinen nicht empfohlen.

AWS Versioning der Konstruktbibliothek

Die Module in der AWS Construct Library durchlaufen verschiedene Phasen, während sie vom Konzept bis zur ausgereiften API entwickelt werden. Verschiedene Stufen bieten in nachfolgenden Versionen von unterschiedliche API-Stabilität AWS CDK.

APIs in der AWS CDK Hauptbibliothek, aws-cdk-lib, sind stabil und die Bibliothek ist vollständig semantisch versioniert. Dieses Paket enthält AWS CloudFormation (L1)-Konstrukte für alle - AWS Services und alle stabilen höherrangigen (L2- und L3) Module. (Er enthält auch die CDK-Kernklassen wie App und Stack). APIs werden erst mit der nächsten Hauptversion des CDK aus diesem Paket entfernt (obwohl sie möglicherweise veraltet sind). Keine einzelne API wird jemals grundlegende Änderungen haben. Wenn eine grundlegende Änderung erforderlich ist, wird eine völlig neue API hinzugefügt.

Neue APIs, die sich in der Entwicklung für einen Service befinden, der bereits in integriert ist, aws-cdk-lib werden mit einem BetaN Suffix identifiziert, wobei bei 1 N beginnt und mit jeder grundlegenden Änderung der neuen API erhöht wird. BetaN APIs werden nie entfernt, sondern sind nur veraltet, sodass Ihre vorhandene App weiterhin mit neueren Versionen von funktioniertaws-cdk-lib. Wenn die API als stabil eingestuft wird, wird eine neue API ohne das BetaN Suffix hinzugefügt.

Wenn High-Level-APIs (L2 oder L3) für einen - AWS Service entwickelt werden, der zuvor nur über L1-APIs verfügte, werden diese APIs zunächst in einem separaten Paket verteilt. Der Name eines solchen Pakets hat ein „Alpha“-Suffix und seine Version entspricht der ersten Version, mit der aws-cdk-lib es kompatibel ist, mit einer -alphaUnterversion. Wenn das Modul die beabsichtigten Anwendungsfälle unterstützt, werden seine APIs zu hinzugefügtaws-cdk-lib.

Stabilität der Sprachbindung

Im Laufe der Zeit fügen wir dem möglicherweise Unterstützung AWS CDK für zusätzliche Programmiersprachen hinzu. Obwohl die in allen Sprachen beschriebene API identisch ist, variiert die Art und Weise, wie die API ausgedrückt wird, je nach Sprache und kann sich ändern, wenn sich die Sprachunterstützung weiterentwickeln. Aus diesem Grund gelten Sprachbindungen für einen bestimmten Zeitraum als experimentell, bis sie als bereit für den Produktionseinsatz gelten.