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 recursos para a CLI do CDK.
Os sinalizadores de recursos controlam o comportamento da CLI do CDK e você pode usá-los para ativar ou desativar recursos específicos. Use o cdk flags comando para visualizar suas configurações atuais de sinalizadores de recursos e modificá-las conforme necessário.
Atenção
O cdk flags comando está em desenvolvimento para o AWS CDK. Os recursos atuais desse comando são considerados prontos para produção e seguros de usar. No entanto, o escopo desse comando e seus recursos estão sujeitos a alterações. Portanto, você deve se inscrever fornecendo a unstable=flags opção de usar esse comando.
Uso
$ cdk flags <arguments> <options>
Argumentos
- NOME DA BANDEIRA
-
O nome do sinalizador de recurso específico que você deseja visualizar ou modificar.
Tipo: string
Obrigatório: não
Opções
Para obter uma lista de opções globais que funcionam com todos os comandos da CLI do CDK, consulte Opções globais.
-
--set <BOOLEAN> -
Modifique a configuração de um sinalizador de recurso.
-
--all <BOOLEAN> -
Modifique ou visualize todas as bandeiras de recursos.
-
--recommended <BOOLEAN> -
Altere os sinalizadores para os estados recomendados.
-
--default <BOOLEAN> -
Altere os sinalizadores para os estados padrão.
-
--unconfigured <BOOLEAN> -
Modifique sinalizadores de recursos não configurados.
-
--value <STRING> -
O valor para definir a configuração do sinalizador de recurso.
requerArg: verdadeiro
-
--safe <BOOLEAN> -
Ative todos os sinalizadores de recursos que não afetam seu aplicativo.
-
--interactive, -i <BOOLEAN> -
Opção interativa para o comando flags.
Exemplos
Exibir configurações de sinalizadores de recursos
Execute cdk flags para ver um relatório das configurações do seu sinalizador de recursos 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 bandeiras são exibidas na seguinte ordem:
-
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 correr cdk flags --all para ver um relatório de todos os sinalizadores de recursos na seguinte ordem:
-
Sinalizadores definidos com um valor que corresponda 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>
Modificar valores da bandeira de recurso
Para modificar seus sinalizadores de recursos de forma interativa, execute cdk flags --interactive (oucdk flags -i) para ver uma lista de opções de menu.
Para alterar cada sinalizador de recurso para nosso valor recomendado, executecdk flags --set --recommended --all. Esse comando mantém a configuração do sinalizador de recurso up-to-date com as configurações mais recentes do sinalizador de recursos 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, executecdk flags --set --recommended --unconfigured. Essa opção altera somente os sinalizadores de recursos 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 recursos não configurados não interfiram em seu aplicativo, execute o cdk flags --set --default --unconfigured comando para alterar os sinalizadores não configurados para seus valores padrão. Por exemplo, se não @aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021 estiver configurado, uma notificação será exibida após a execuçãocdk synth. No entanto, se você definir o sinalizador para seu estado padrão (falso), ele será configurado, desativado e não afetará seu aplicativo.
$ 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...
Inspecione sinalizadores de recursos específicos
Exibir mais informações sobre uma bandeira
Além de executar cdk flags e visualizar cdk flags --all a configuração do sinalizador de recurso, você também pode usá-lo cdk flags "FLAGNAME" para inspecionar um sinalizador de recurso 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 em seu aplicativo.
$ 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
Filtrar sinalizadores por substring
Você também pode correr cdk flags substring para ver todas as bandeiras de recursos correspondentes. Se houver apenas um sinalizador de recurso 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, todas as bandeiras correspondentes que contêm qualquer uma das substrings serão retornadas.
$ 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>
Modificar uma bandeira específica
Se você precisar modificar o valor de um sinalizador e quiser ter certeza de que está configurando-o para um estado correto e compatível, executecdk 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...
