Este é o Guia do desenvolvedor do AWS CDK v2. O CDK v1 antigo entrou em manutenção em 1º de junho de 2022 e encerrou o suporte em 1º de junho de 2023.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
cdk flags
Visualize e modifique suas configurações de sinalizadores de atributos para a CLI do CDK.
Os sinalizadores de atributos controlam o comportamento da CLI do CDK e é possível usá-los para habilitar ou desabilitar recursos específicos. Use o comando cdk flags para visualizar suas configurações atuais de sinalizadores de atributos e modificá-las conforme necessário.
Atenção
O comando cdk flags está em desenvolvimento para o AWS CDK. Os atributos atuais desse comando são considerados prontos para produção e seguros de usar. Contudo, o escopo desse comando e seus atributos estão sujeitos a alterações. Sendo assim, é necessário se cadastrar fornecendo a opção unstable=flags de usar esse comando.
Uso
$ cdk flags <arguments> <options>
Argumentos
- FLAGNAME
-
O nome do sinalizador de atributo específico que você deseja visualizar ou modificar.
Tipo: string
Obrigatório: não
Opções
Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte Opções globais.
-
--set <BOOLEAN> -
Modifica uma configuração de sinalizador de atributo.
-
--all <BOOLEAN> -
Modifica ou visualiza todos os sinalizadores de atributos.
-
--recommended <BOOLEAN> -
Altera os sinalizadores para os estados recomendados.
-
--default <BOOLEAN> -
Altera os sinalizadores para os estados padrão.
-
--unconfigured <BOOLEAN> -
Modifica sinalizadores de atributos não configurados.
-
--value <STRING> -
O valor para definir a configuração do sinalizador de atributo.
requiresArg: verdadeiro
-
--safe <BOOLEAN> -
Habilita todos os sinalizadores de atributos que não afetam a sua aplicação.
-
--interactive, -i <BOOLEAN> -
Opção interativa para o comando flags.
Exemplos
Visualizar configurações de sinalizadores de atributos
Execute cdk flags para exibir um relatório das configurações do seu sinalizador de atributos que diferem dos nossos estados recomendados. Os sinalizadores não configurados são rotulados com <unset> para indicar que o sinalizador atualmente não tem valor. As sinalizadores são exibidos na ordem a seguir:
-
Sinalizadores definidos com um valor que não corresponde ao nosso valor recomendado
-
Sinalizadores que você não configurou
$ cdk flags --unstable=flags Feature Flag Recommended User * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true <unset>
Você também pode executar cdk flags --all para exibir um relatório de todos os sinalizadores de atributos na ordem a seguir:
-
Sinalizadores definidos com um valor que corresponde ao nosso valor recomendado
-
Sinalizadores definidos com um valor que não corresponde ao nosso valor recomendado
-
Sinalizadores que você não configurou
$ 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>
Modificação de valores de sinalizadores de atributos
Para modificar seus sinalizadores de atributos de forma interativa, execute cdk flags --interactive (ou cdk flags -i) para ver uma lista de opções de menu.
Para alterar cada sinalizador de atributo para nosso valor recomendado, execute cdk flags --set --recommended --all. Esse comando mantém a configuração do sinalizador de atributo atualizada com as configurações mais recentes do sinalizador de atributos do CDK. Esteja ciente de que a execução desse comando pode potencialmente substituir os 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...
Se você quiser preservar o estado dos seus sinalizadores configurados existentes, execute cdk flags --set --recommended --unconfigured. Essa opção altera somente os sinalizadores de atributos não configurados para nossos 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...
Se você quiser garantir que quaisquer sinalizadores de atributos não configurados não interfiram na sua aplicação, execute o comando cdk flags --set --default --unconfigured para alterar os sinalizadores não configurados para seus valores padrão. Por exemplo, se @aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021 não estiver configurado, uma notificação será exibida após a execução de cdk synth. No entanto, se você definir o sinalizador para seu estado padrão (falso), ele será configurado, desativado e não afetará sua aplicação.
$ 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...
Inspeção de sinalizadores de atributos específicos
Visualização de mais informações sobre um sinalizador
Além de executar cdk flags e cdk flags --all para exibir sua configuração de sinalizadores de atributos, você também pode usar cdk flags "FLAGNAME" para inspecionar um sinalizador de atributo específico e descobrir o que o sinalizador faz. Isso pode ser útil nos casos em que você deseja entender um sinalizador específico e seu impacto na sua aplicação.
$ 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
Filtragem de sinalizadores por substring
Você também pode executar cdk flags substring para exibir todos os sinalizadores de atributos correspondentes. Se houver apenas um sinalizador de atributo que corresponda a essa substring, detalhes específicos serão exibidos.
$ 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
Se vários sinalizadores corresponderem à substring, todos os sinalizadores correspondentes serão exibidos em uma tabela. Se você inserir várias substrings, todos os sinalizadores correspondentes que contenham qualquer uma das substrings serão retornados.
$ 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>
Modificação de um sinalizador específico
Se você precisar modificar o valor de um sinalizador e quiser ter certeza de que está configurando-o para um estado correto e com suporte, execute 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...
