cdk flags - AWS Kit Cloud Development Kit (AWS CDK) v2
UsoArgumentosOpcionesEjemplos

Esta es la guía para desarrolladores de AWS CDK v2. La primera versión del CDK pasó a la etapa de mantenimiento el 1.° de junio de 2022 y no cuenta con soporte desde el 1.° de junio de 2023.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

cdk flags

Vea y modifique las configuraciones de su marca de características para la CLI de CDK.

Las marcas de características controlan el comportamiento de la CLI de CDK y puede utilizarlos para habilitar o deshabilitar características específicas. Utilice el comando cdk flags para ver las configuraciones actuales de las marcas de características y modifíquelas según sea necesario.

aviso

El comando cdk flags está en desarrollo para el AWS CDK. Se considera que las funciones actuales de este comando están listas para la producción y son seguras de usar. Sin embargo, el alcance de este comando y sus funciones están sujetos a cambios. Por lo tanto, debe suscribirse proporcionando la opción unstable=flags usar este comando.

Uso

$ cdk flags <arguments> <options>

Argumentos

NOMBRE DE LA MARCA

El nombre de la marca de características específica que desea ver o modificar algo.

Tipo: cadena

Obligatorio: no

Opciones

Para obtener una lista de las opciones globales que funcionan con todos los comandos de la CLI de CDK, consulte Opciones globales.

--set <BOOLEAN>

Modifique la configuración de una marca de características.

--all <BOOLEAN>

Modifique o vea todos las marcas de características.

--recommended <BOOLEAN>

Cambie las marcas a los estados recomendados.

--default <BOOLEAN>

Cambie las marcas a los estados predeterminados.

--unconfigured <BOOLEAN>

Modifique las marcas de características no configuradas.

--value <STRING>

El valor en el que se va a establecer la configuración de la marca de características.

requireArg: true

--safe <BOOLEAN>

Active todos las marcas de características que no afecten a su aplicación.

--interactive, -i <BOOLEAN>

Opción interactiva para el comando de marcas.

Ejemplos

Ver las configuraciones de los marcadores de características

Ejecute cdk flags para ver un informe con las configuraciones de sus marcas de características que difieran de nuestros estados recomendados. Los indicadores no configurados se etiquetan con <unset> para indicar que la marca no tiene ningún valor en este momento. Las marcas se muestran en el siguiente orden:

  • Las marcas tienen un valor que no coincide con nuestro valor recomendado

  • Marcas de características que no ha configurado

$ cdk flags --unstable=flags
Feature Flag                           Recommended                       User
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>

También puede ejecutar cdk flags --all para ver un informe con todas las marcas de características en el siguiente orden:

  • Las marcas tienen un valor que coincide con nuestro valor recomendado

  • Las marcas tienen un valor que no coincide con nuestro valor recomendado

  • Marcas de características que no ha configurado

$ cdk flags --unstable=flags --all
Feature Flag                              Recommended                     User
@aws-cdk/...                                true                         true
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>

Modificar los valores de las marcas de características

Para modificar sus marcas de características de forma interactiva, ejecute cdk flags --interactive (o cdk flags -i) para ver una lista de opciones del menú.

Para cambiar cada marca de características a nuestro valor recomendado, ejecute cdk flags --set --recommended --all. Este comando mantiene la configuración de las marcas de características actualizada con las últimas configuraciones de marcas de características de CDK. Tenga en cuenta que la ejecución de este comando puede sobrescribir los valores existentes configurados.

$ cdk flags --unstable=flags --set --recommended --all
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
  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 desea conservar el estado de las marcas configurados existentes, ejecute cdk flags --set --recommended --unconfigured. Esta opción cambia solo las marcas de características no configuradas a nuestros valores recomendados.

$ cdk flags --unstable=flags --set --recommended --unconfigured
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         <unset>
* @aws-cdk/...                              true                         <unset>
  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...

Si quiere asegurarse de que las marcas de características no configuradas no interfieran con la aplicación, ejecute el comando cdk flags --set --default --unconfigured para cambiar las marcas no configuradas a sus valores predeterminados. Por ejemplo, si @aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021 no está configurado, se muestra una notificación después de ejecutar cdk synth. Sin embargo, si establece la marca en su estado predeterminado (false), se configurará, se desactivará y no afectará a la aplicación.

$ cdk flags --unstable=flags --set --default --unconfigured
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         <unset>
* @aws-cdk/...                              true                         <unset>
  Synthesizing...

  Do you want to accept these changes? (y/n) y
  Resynthesizing...

Inspeccione las marcas de características

Ver más información sobre una marca

Además de ejecutar cdk flags y cdk flags --all para ver la configuración de su marca de características, también puede utilizar cdk flags "FLAGNAME" para inspeccionar una marca de características específico y averiguar qué hace esa marca. Esto puede resultar útil en los casos en los que desee comprender una marca en particular y su impacto en la aplicación.

$ 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

Filtre las marcas por subcadena

También puede ejecutar cdk flags substring para ver todos las marcas de características coincidentes. Si solo hay una marca de entidad que coincide con esa subcadena, se muestran detalles específicos.

$ 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 varias marcas coinciden con la subcadena, todas las marcas coincidentes se muestran en una tabla. Si introduce varias subcadenas, se devolverán todas las marcas coincidentes que contengan alguna de las subcadenas.

$ cdk flags --unstable=flags s3 lambda
Feature Flag                              Recommended                     User
* @aws-cdk/s3...                            true                         false
* @aws-cdk/lambda...                        true                         false
* @aws-cdk/lambda...                        true                         <unset>

Modifique una marca específica

Si necesita modificar el valor de una marca y quiere asegurarse de que está configurándola en un estado correcto y compatible, ejecute 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...