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 ``` ## 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](ref-cli-cmd.md#ref-cli-cmd-options). `--set ` Modifique la configuración de una marca de características. `--all ` Modifique o vea todos las marcas de características. `--recommended ` Cambie las marcas a los estados recomendados. `--default ` Cambie las marcas a los estados predeterminados. `--unconfigured ` Modifique las marcas de características no configuradas. `--value ` El valor en el que se va a establecer la configuración de la marca de características. *requireArg*: true `--safe ` Active todos las marcas de características que no afecten a su aplicación. `--interactive, -i ` 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 `` 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 ``` 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 ``` ### 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 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 * @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... ``` 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 * @aws-cdk/... true 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 ``` #### 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... ```