Ceci est le guide du AWS CDK développeur de la version 2. L'ancienne CDK version 1 est entrée 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.

AWS CDK gestion des versions

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 aux API stables 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 CDKCLIcompatibilité

Le AWS CDK CLI est toujours compatible avec les bibliothèques de construction dont le numéro de version est sémantiquement inférieur ou égal. Il est donc toujours prudent de les mettre à niveau AWS CDK CLI dans la même version majeure.

Le n' AWS CDK CLIest pas toujours compatible avec les bibliothèques de construction d'une version sémantiquement supérieure. La compatibilité dépend de l'utilisation de la même version du schéma d'assemblage cloud par les deux composants. Le AWS CDK framework génère un assemblage cloud lors de la synthèse, puis le AWS CDK CLI consomme pour le déploiement. Le schéma qui définit le format de l'assemblage cloud est strictement spécifié et versionné.

AWS les bibliothèques de construction utilisant une version de schéma d'assemblage cloud donnée sont compatibles avec AWS CDK CLI les versions utilisant cette version de schéma ou une version ultérieure. Cela peut inclure des versions antérieures AWS CDK CLI à une version de bibliothèque de construction donnée.

Lorsque la version d'assemblage cloud requise par la bibliothèque de constructions n'est pas compatible avec la version prise en charge par le AWS CDK CLI, vous recevez un message d'erreur du type 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 AWS 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.

Les API de la AWS CDK bibliothèque principale sont stables et la bibliothèque est entièrement versionnée sémantiquement. aws-cdk-lib 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). Les API ne seront pas supprimées de ce package (bien qu'elles puissent être obsolètes) avant la prochaine version majeure du CDK. Aucune API individuelle ne subira de modifications majeures. Lorsqu'une modification radicale est requise, une toute nouvelle API sera ajoutée.

Les nouvelles API en cours de développement pour un service déjà intégré aws-cdk-lib sont identifiées à l'aide d'un BetaN suffixe, qui N commence à 1 et est incrémenté à chaque modification importante apportée à la nouvelle API. BetaN Les API ne sont jamais supprimées, elles sont uniquement déconseillées, 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 API de niveau supérieur (L2 ou L3) commencent à être développées pour un AWS service qui ne possédait auparavant que des API L1, ces API sont initialement distribuées dans un package distinct. 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, ses API sont ajoutéesaws-cdk-lib.

Stabilité des liaisons linguistiques

Au fil du temps, nous pourrons ajouter 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 à 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.