AWS CDK gestion des versions

Ceci est le guide du AWS CDK développeur de la version 2. L'ancien CDK v1 est entré en maintenance le 1er juin 2022 et a pris fin le 1er juin 2023.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Ceci est le guide du AWS CDK développeur de la version 2. L'ancien CDK v1 est entré en maintenance le 1er juin 2022 et a pris fin le 1er juin 2023.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Cette rubrique fournit des informations de référence sur la manière dont le AWS Cloud Development Kit (AWS CDK) versionnage est géré.

Les numéros de version se composent de trois parties numériques : majeure. mineur. patch, et respectez strictement le modèle de versionnement sémantique. Cela signifie que les modifications majeures apportées à la APIs version stable sont limitées aux versions majeures.

Les versions mineures et les correctifs sont rétrocompatibles. Le code écrit dans une version précédente avec la même version majeure peut être mis à niveau vers une version plus récente au sein de la même version majeure. Il continuera également à se développer et à fonctionner, produisant le même résultat.

AWS CDK CLI compatibilité

Chaque version de la AWS CDK bibliothèque principale (aws-cdk-lib) est compatible avec AWS CDK CLI (aws-cdk-cli) version en cours au moment de la publication de la bibliothèque CDK. Il est également compatible avec toute version plus récente du CDK CLI. Chaque version de la bibliothèque CDK conserve cette compatibilité jusqu'à la date de fin de vie de la bibliothèque. Par conséquent, tant que vous utilisez une version de bibliothèque de CDK prise en charge, vous pouvez toujours mettre à niveau votre CDK en toute sécurité CLI version.

Chaque version de la bibliothèque CDK peut également fonctionner avec CDK CLI versions antérieures à la version en cours au moment de la publication de la bibliothèque CDK. Toutefois, cela n'est pas garanti. La compatibilité dépend de la version du schéma d'assemblage cloud de la bibliothèque CDK. AWS CDK Génère un assemblage cloud lors de la synthèse et du CDK CLI le consomme pour le déploiement. Le schéma qui définit le format de l'assemblage cloud est strictement spécifié et versionné. Par conséquent, une ancienne version du CDK CLI devraient prendre en charge la version du schéma d'assemblage cloud de la bibliothèque CDK pour être compatibles.

Lorsque la version d'assemblage cloud requise par la bibliothèque CDK n'est pas compatible avec la version prise en charge par le CDK CLI, vous recevez un message d'erreur semblable au suivant :

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.

Pour résoudre cette erreur, mettez à jour le CDK CLI vers une version compatible avec la version d'assemblage cloud requise ou vers la dernière version disponible. L'alternative (rétrograder les modules de la bibliothèque de construction utilisés par votre application) n'est généralement pas recommandée.

AWS Gestion des versions de la bibliothèque Construct

Les modules de la bibliothèque AWS Construct passent par différentes étapes au fur et à mesure qu'ils passent du concept à l'API mature. Les différentes étapes offrent différents degrés de stabilité de l'API dans les versions suivantes du AWS CDK.

APIs dans la AWS CDK bibliothèque principaleaws-cdk-lib, sont stables et la bibliothèque est entièrement versionnée sémantiquement. Ce package inclut des constructions AWS CloudFormation (L1) pour tous les AWS services et tous les modules stables de niveau supérieur (L2 et L3). (Il inclut également les classes CDK de base telles que App etStack). APIs ne seront pas supprimés de ce package (bien qu'ils puissent être obsolètes) avant la prochaine version majeure du CDK. Aucune API individuelle ne subira de modifications majeures. Lorsqu'une modification majeure est requise, une toute nouvelle API sera ajoutée.

Les nouveaux services en APIs cours de développement pour un service déjà intégré aws-cdk-lib sont identifiés à l'aide d'un BetaN suffixe, qui N commence à 1 et est incrémenté à chaque modification importante apportée à la nouvelle API. BetaN APIs ne sont jamais supprimés, mais uniquement obsolètes, de sorte que votre application existante continue de fonctionner avec les nouvelles versions de. aws-cdk-lib Lorsque l'API est jugée stable, une nouvelle API sans BetaN suffixe est ajoutée.

Lorsque des niveaux supérieurs (L2 ou L3) APIs commencent à être développés pour un AWS service qui ne comportait auparavant que la couche L1 APIs, ceux-ci APIs sont initialement distribués dans un package séparé. Le nom d'un tel package possède le suffixe « Alpha », et sa version correspond à la première version compatible avec une alpha sous-version. aws-cdk-lib Lorsque le module prend en charge les cas d'utilisation prévus, APIs il est ajouté àaws-cdk-lib.

Stabilité des liaisons linguistiques

Au fil du temps, il se peut que nous ajoutions la prise en charge AWS CDK de quatre langages de programmation supplémentaires. Bien que l'API décrite dans toutes les langues soit la même, la façon dont l'API est exprimée varie selon la langue et peut changer au fur et à mesure que le support linguistique évolue. Pour cette raison, les liaisons linguistiques sont considérées comme expérimentales pendant un certain temps jusqu'à ce qu'elles soient considérées comme prêtes à être utilisées en production.