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 sus indicadores de función para la CLI de CDK.

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

aviso

El cdk flags comando 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 unstable=flags opción de usar este comando.

Uso

$ cdk flags <arguments> <options>

Argumentos

NOMBRE DE LA BANDERA

El nombre del indicador de función específico que desea ver o modificar.

Tipo: cadena

Obligatorio: no

Opciones

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

--set <BOOLEAN>

Modifique la configuración de un indicador de función.

--all <BOOLEAN>

Modifique o vea todos los indicadores de características.

--recommended <BOOLEAN>

Cambie las banderas a los estados recomendados.

--default <BOOLEAN>

Cambie las banderas a los estados predeterminados.

--unconfigured <BOOLEAN>

Modifique los indicadores de funciones no configurados.

--value <STRING>

El valor en el que se va a establecer la configuración del indicador de función.

requireArg: true

--safe <BOOLEAN>

Active todos los indicadores de funciones que no afecten a su aplicación.

--interactive, -i <BOOLEAN>

Opción interactiva para el comando flags.

Ejemplos

Vea las configuraciones de los indicadores de funciones

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

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

  • Banderas que no has configurado

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

También puedes correr cdk flags --all para ver un informe con todos los indicadores de funciones en el siguiente orden:

  • Marcadores configurados en un valor que coincide con nuestro valor recomendado

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

  • Banderas que no has 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>

Modifique los valores de los indicadores de funciones

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

Para cambiar cada indicador de función a nuestro valor recomendado, ejecutacdk flags --set --recommended --all. Este comando mantiene la configuración de los indicadores de funciones up-to-date con las últimas configuraciones de indicadores de funciones del CDK. Tenga en cuenta que la ejecución de este comando puede sobrescribir los valores configurados existentes.

$ 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 los indicadores configurados existentes, ejecutecdk flags --set --recommended --unconfigured. Esta opción cambia solo los indicadores de funciones no configurados 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 los indicadores de funciones no configurados no interfieran con la aplicación, ejecute el cdk flags --set --default --unconfigured comando para cambiar los indicadores no configurados a sus valores predeterminados. Por ejemplo, si no @aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021 está configurado, se muestra una notificación después de ejecutarlo. cdk synth Sin embargo, si estableces el indicador 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 los indicadores de funciones específicas

Ver más información sobre una bandera

Además de ejecutar cdk flags y cdk flags --all ver la configuración de su indicador de característica, también puede utilizarlo cdk flags "FLAGNAME" para inspeccionar un indicador de característica específico y averiguar qué hace ese indicador. Esto puede resultar útil en los casos en los que desee comprender un indicador 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

Filtra los indicadores por subcadena

También puedes correr cdk flags substring para ver todos los indicadores de características coincidentes. Si solo hay un indicador 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 varios indicadores coinciden con la subcadena, todos los indicadores 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 un indicador específico

Si necesitas modificar el valor de una marca y quieres asegurarte de que está configurándola en un estado correcto y compatible, ejecutacdk 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...