Ceci est le guide du développeur du AWS CDK v2. 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. # `cdk flags` Affichez et modifiez les configurations de vos indicateurs de fonctionnalité pour la CLI CDK. Les indicateurs de fonctionnalité contrôlent le comportement de la CLI CDK et vous pouvez les utiliser pour activer ou désactiver des fonctionnalités spécifiques. Utilisez la `cdk flags` commande pour afficher les configurations actuelles de vos indicateurs de fonctionnalité et modifiez-les selon vos besoins. **Avertissement** La `cdk flags` commande est en cours de développement pour le AWS CDK. Les fonctionnalités actuelles de cette commande sont considérées comme prêtes pour la production et peuvent être utilisées en toute sécurité. Cependant, la portée de cette commande et ses fonctionnalités sont susceptibles d'être modifiées. Par conséquent, vous devez vous inscrire en fournissant l'`unstable=flags`option d'utiliser cette commande. ## Utilisation ``` $ cdk flags ``` ## Arguments **NOM DU DRAPEAU** Le nom de l'indicateur de fonctionnalité spécifique que vous souhaitez afficher ou modifier. *Type* : chaîne *Obligatoire* : non ## Options Pour une liste des options globales qui fonctionnent avec toutes les commandes de la CLI CDK, consultez la section [Options globales](ref-cli-cmd.md#ref-cli-cmd-options). `--set ` Modifiez la configuration d'un indicateur de fonctionnalité. `--all ` Modifiez ou affichez tous les indicateurs de fonctionnalités. `--recommended ` Remplacez les drapeaux par les états recommandés. `--default ` Remplacez les drapeaux par défaut. `--unconfigured ` Modifiez les indicateurs de fonctionnalités non configurés. `--value ` La valeur à laquelle définir la configuration de l'indicateur de fonctionnalité. *requireArg* : vrai `--safe ` Activez tous les indicateurs de fonctionnalités qui n'ont aucun impact sur votre application. `--interactive, -i ` Option interactive pour la commande flags. ## Exemples ### Afficher les configurations des indicateurs de fonctionnalités Exécutez `cdk flags` pour afficher un rapport sur les configurations de vos indicateurs de fonctionnalités qui diffèrent des états recommandés. Les drapeaux non configurés sont étiquetés avec une `` étiquette indiquant qu'ils n'ont actuellement aucune valeur. Les drapeaux sont affichés dans l'ordre suivant : + Drapeaux définis sur une valeur qui ne correspond pas à notre valeur recommandée + Drapeaux que vous n'avez pas configurés ``` $ cdk flags --unstable=flags Feature Flag Recommended User * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true ``` Vous pouvez également exécuter `cdk flags --all` pour voir un rapport de tous les indicateurs de fonctionnalités dans l'ordre suivant : + Drapeaux définis sur une valeur correspondant à notre valeur recommandée + Drapeaux définis sur une valeur qui ne correspond pas à notre valeur recommandée + Drapeaux que vous n'avez pas configurés ``` $ cdk flags --unstable=flags --all Feature Flag Recommended User @aws-cdk/... true true * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true ``` ### Modifier les valeurs des indicateurs de fonction Pour modifier vos indicateurs de fonctionnalités de manière interactive, exécutez `cdk flags --interactive` (ou`cdk flags -i`) pour afficher une liste d'options de menu. Pour remplacer chaque indicateur de fonctionnalité par notre valeur recommandée, exécutez`cdk flags --set --recommended --all`. Cette commande conserve la configuration de votre indicateur de fonctionnalité up-to-date avec les dernières configurations d'indicateur de fonctionnalité du CDK. Sachez que l'exécution de cette commande peut potentiellement remplacer les valeurs configurées existantes. ``` $ cdk flags --unstable=flags --set --recommended --all Feature Flag Recommended Value User Value * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true Synthesizing... Resources [~] AWS::S3::Bucket MyBucket └─ [~] Properties └─ [~] Encryption ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing... ``` Si vous souhaitez conserver l'état de vos drapeaux configurés existants, exécutez`cdk flags --set --recommended --unconfigured`. Cette option remplace uniquement les indicateurs de fonctionnalité non configurés par nos valeurs recommandées. ``` $ cdk flags --unstable=flags --set --recommended --unconfigured Feature Flag Recommended Value User Value * @aws-cdk/... true * @aws-cdk/... true Synthesizing... Resources [~] AWS::S3::Bucket MyBucket └─ [~] Properties └─ [~] Encryption ├─ [-] None └─ [+] ServerSideEncryptionConfiguration: - ... ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing... ``` Pour vous assurer qu'aucun indicateur de fonctionnalité non configuré n'interfère avec votre application, exécutez la `cdk flags --set --default --unconfigured` commande pour rétablir les valeurs par défaut des indicateurs non configurés. Par exemple, s'il `@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021` n'est pas configuré, une notification s'affiche après l'exécution`cdk synth`. Toutefois, si vous réglez l'indicateur sur son état par défaut (faux), il sera configuré, désactivé et n'aura aucun impact sur votre application. ``` $ cdk flags --unstable=flags --set --default --unconfigured Feature Flag Recommended Value User Value * @aws-cdk/... true * @aws-cdk/... true Synthesizing... Do you want to accept these changes? (y/n) y Resynthesizing... ``` ### Inspectez les indicateurs de fonctionnalités spécifiques #### Afficher plus d'informations sur un drapeau En plus d'exécuter `cdk flags` et de `cdk flags --all` visualiser la configuration de votre indicateur de fonctionnalité, vous pouvez également l'utiliser `cdk flags "FLAGNAME"` pour inspecter un indicateur de fonctionnalité spécifique et découvrir à quoi sert cet indicateur. Cela peut être utile dans les cas où vous souhaitez comprendre un indicateur en particulier et son impact sur votre application. ``` $ cdk flags --unstable=flags "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" Description: Enable this feature flag to have cloudfront distributions use the security policy TLSv1.2_2021 by default. Recommended Value: true User Value: true ``` #### Filtrer les drapeaux par sous-chaîne Vous pouvez également courir `cdk flags substring` pour voir tous les indicateurs de fonctionnalités correspondants. Si un seul indicateur de fonctionnalité correspond à cette sous-chaîne, des détails spécifiques sont affichés. ``` $ cdk flags --unstable=flags ebs @aws-cdk/aws-ec2:ebsDefaultGp3Volume Description: When enabled, the default volume type of the EBS volume will be GP3 Recommended Value: true User Value: true ``` Si plusieurs indicateurs correspondent à la sous-chaîne, tous les indicateurs correspondants sont affichés dans un tableau. Si vous entrez plusieurs sous-chaînes, tous les indicateurs correspondants contenant l'une des sous-chaînes sont renvoyés. ``` $ cdk flags --unstable=flags s3 lambda Feature Flag Recommended User * @aws-cdk/s3... true false * @aws-cdk/lambda... true false * @aws-cdk/lambda... true ``` #### Modifier un drapeau spécifique Si vous devez modifier la valeur d'un indicateur et vous assurer que vous le définissez sur un état correct et compatible, exécutez`cdk flags --set "FLAGNAME" --value="state"`. ``` $ cdk flags --unstable=flags --set "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" --value="true" Synthesizing... Resources [~] AWS::CloudFront::Distribution MyDistribution └─ [~] Properties └─ [~] DefaultSecurityPolicy ├─ [-] TLSv1.0 └─ [+] TLSv1.2_2021 - ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing... ```