AWS CDK Versionierung

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.

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.

Dieses Thema enthält Referenzinformationen zur AWS Cloud Development Kit (AWS CDK) Handhabung der Versionierung.

Versionsnummern bestehen aus drei numerischen Versionsteilen: Hauptversion. geringfügig. patchen und sich strikt an das semantische Versionierungsmodell halten. Das bedeutet, dass grundlegende Änderungen an Stable auf Hauptversionen beschränkt APIs sind.

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

AWS CDK CLI Kompatibilität

Jede Version der AWS CDK Hauptbibliothek (aws-cdk-lib) ist kompatibel mit AWS CDK CLI (aws-cdk-cli) Version, die zum Zeitpunkt der Veröffentlichung der CDK-Bibliothek aktuell war. Sie ist auch mit jeder neueren Version des CDK kompatibel CLI. Jede Version der CDK-Bibliothek behält diese Kompatibilität bis zum Ende des Lebenszyklus der Bibliothek bei. Solange Sie eine unterstützte CDK-Bibliotheksversion verwenden, ist es daher immer sicher, Ihr CDK zu aktualisieren CLI Version.

Jede Version der CDK-Bibliothek kann auch mit CDK funktionieren CLI Versionen, die älter sind als die Version, die zum Zeitpunkt der Veröffentlichung der CDK-Bibliothek aktuell war. Dies ist jedoch nicht garantiert. Die Kompatibilität hängt von der Cloud-Assembly-Schemaversion der CDK-Bibliothek ab. Das AWS CDK generiert während der Synthese und des CDK eine Cloud-Assembly CLI verbraucht es für die Bereitstellung. Das Schema, das das Format der Cloud-Assembly definiert, ist streng spezifiziert und versioniert. Daher eine ältere Version des CDK CLI müsste die Cloud-Assembly-Schemaversion der CDK-Bibliothek unterstützen, damit sie kompatibel sind.

Wenn die von der CDK-Bibliothek benötigte Cloud-Assembly-Version nicht mit der vom CDK unterstützten Version kompatibel ist 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 das CDK CLI auf eine Version, die mit der erforderlichen Cloud Assembly-Version kompatibel ist, oder auf die neueste verfügbare Version. Die Alternative (Herabstufung der Module der Construct-Bibliothek, die Ihre App verwendet) wird im Allgemeinen nicht empfohlen.

AWS Versionierung der Construct-Bibliothek

Die Module in der AWS Construct Library durchlaufen bei ihrer Entwicklung vom Konzept bis zur ausgereiften API verschiedene Phasen. Verschiedene Phasen bieten unterschiedliche API-Stabilität in nachfolgenden Versionen von AWS CDK.

APIs in der AWS CDK Hauptbibliothek sind sie stabil, und die Bibliothek ist vollständig semantisch versioniert. aws-cdk-lib Dieses Paket enthält AWS CloudFormation (L1) -Konstrukte für alle AWS Dienste und alle stabilen Module auf höherer Ebene (L2 und L3). (Es enthält auch die CDK-Kernklassen wie und). App 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 Dienste, die sich in der Entwicklung aws-cdk-lib befinden, werden anhand eines BetaN Suffixes identifiziert, das bei 1 N beginnt und bei jeder grundlegenden Änderung an der neuen API erhöht wird. BetaN APIs werden nie entfernt, sondern nur veraltet, sodass Ihre bestehende App weiterhin mit neueren Versionen von funktioniert. aws-cdk-lib Wenn die API als stabil eingestuft wird, wird eine neue API ohne das BetaN Suffix hinzugefügt.

Wenn mit der Entwicklung einer höheren Ebene (L2 oder L3) für einen AWS Dienst APIs begonnen wird, für den zuvor nur L1 verfügbar war APIs, APIs werden diese zunächst in einem separaten Paket verteilt. Der Name eines solchen Pakets hat das Suffix „Alpha“, und seine Version entspricht der ersten Version, mit der aws-cdk-lib es kompatibel ist, mit einer Unterversion. alpha Wenn das Modul die vorgesehenen Anwendungsfälle unterstützt, APIs werden diese hinzugefügt. aws-cdk-lib

Stabilität der Sprachbindung

Im Laufe der Zeit werden wir möglicherweise Unterstützung AWS CDK für weitere Programmiersprachen hinzufügen. Obwohl die in allen Sprachen beschriebene API dieselbe ist, variiert die Art und Weise, wie die API ausgedrückt wird, je nach Sprache und kann sich ändern, wenn sich die Sprachunterstützung weiterentwickelt. Aus diesem Grund gelten Sprachbindungen eine Zeit lang als experimentell, bis sie als produktionsbereit gelten.