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.
AWS CDK Utilise des indicateurs de fonctionnalité pour activer des comportements potentiellement perturbateurs dans une version. Les drapeaux sont stockés sous forme de Les valeurs contextuelles et le AWS CDK valeurs dans cdk.json (ou~/.cdk.json). Ils ne sont pas supprimés par les cdk context --clear commandes cdk context --reset or.
Les indicateurs de fonctionnalité sont désactivés par défaut. Les projets existants qui ne spécifient pas le drapeau continueront de fonctionner comme avant dans les AWS CDK versions ultérieures. cdk initLes nouveaux projets créés à l'aide d'indicateurs d'inclusion activant toutes les fonctionnalités disponibles dans la version qui a créé le projet. Modifiez cdk.json pour désactiver les indicateurs pour lesquels vous préférez le comportement antérieur. Vous pouvez également ajouter des indicateurs pour activer de nouveaux comportements après la mise à niveau du AWS CDK.
Une liste de tous les indicateurs de fonctionnalités actuels se trouve dans le AWS CDK GitHub référentiel dans FEATURE_FLAGS.mdCHANGELOG dans une version donnée pour une description de toutes les nouvelles fonctionnalités ajoutées dans cette version.
Revenir au comportement de la version 1
Dans CDK v2, les valeurs par défaut de certains indicateurs de fonctionnalité ont été modifiées par rapport à la v1. Vous pouvez les redéfinir sur false pour revenir à un comportement AWS CDK v1 spécifique. Utilisez la cdk diff commande pour inspecter les modifications apportées à votre modèle synthétisé afin de déterminer si l'un de ces indicateurs est nécessaire.
@aws-cdk/core:newStyleStackSynthesis-
Utilisez la nouvelle méthode de synthèse des piles, qui suppose des ressources bootstrap portant des noms connus. Nécessite un amorçage moderne, mais permet à son tour le CI/CD via CDK Pipelines et les déploiements entre comptes prêts à l'emploi.
@aws-cdk/aws-apigateway:usagePlanKeyOrderInsensitiveId-
Si votre application utilise plusieurs clés d'API Amazon API Gateway et les associe à des plans d'utilisation.
@aws-cdk/aws-rds:lowercaseDbIdentifier-
Si votre application utilise une instance de base de données Amazon RDS ou des clusters de base de données et qu'elle spécifie explicitement leur identifiant.
@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021-
Si votre application utilise la politique de sécurité TLS_V1_2_2019 avec les distributions. Amazon CloudFront Le CDK v2 utilise la politique de sécurité TLSv1 .2_2021 par défaut.
@aws-cdk/core:stackRelativeExports-
Si votre application utilise plusieurs piles et que vous faites référence aux ressources d'une pile à l'autre, cela détermine si le chemin absolu ou relatif est utilisé pour créer AWS CloudFormation les exportations.
@aws-cdk/aws-lambda:recognizeVersionProps-
S'il est défini sur
false, le CDK inclut des métadonnées lorsqu'il détecte si une fonction Lambda a changé. Cela peut entraîner des échecs de déploiement lorsque seules les métadonnées ont changé, car les versions dupliquées ne sont pas autorisées. Il n'est pas nécessaire d'annuler cet indicateur si vous avez apporté au moins une modification à toutes les fonctions Lambda de votre application.
La syntaxe permettant de rétablir ces drapeaux cdk.json est indiquée ici.
{
"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
}
}