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á.
Sinalizadores de atributo do AWS CDK
O AWS CDK usa sinalizadores de atributos para habilitar comportamentos potencialmente incorretos em uma versão. Os sinalizadores são armazenados como valores de contexto e valores do AWS CDK em cdk.json (ou ~/.cdk.json). Eles não são removidos pelos comandos cdk context --reset ou cdk context --clear.
Sinalizadores de atributo são desabilitados por padrão. Os projetos existentes que não especifiquem o sinalizador continuarão funcionando como antes nas versões posteriores do AWS CDK. Novos projetos criados usando cdk init incluem sinalizadores que habilitam todos os atributos disponíveis na versão que criou o projeto. Edite o cdk.json para desativar todos os sinalizadores para os quais você prefere o comportamento anterior. Você também pode adicionar sinalizadores para ativar novos comportamentos após a atualização do AWS CDK.
Uma lista de todos os sinalizadores de atributos atuais pode ser encontrada no repositório do GitHub do AWS CDK em FEATURE_FLAGS.mdCHANGELOG em uma determinada versão para obter uma descrição de quaisquer novos sinalizadores de atributos adicionados nessa versão.
Revertendo para o comportamento v1
No CDK v2, os padrões de alguns sinalizadores de atributos foram alterados em relação à v1. É possível configurá-los novamente para reverter o false para um comportamento específico do AWS CDK v1. Use o comando cdk diff para inspecionar as alterações em seu modelo sintetizado e ver se algum desses sinalizadores é necessário.
-
@aws-cdk/core:newStyleStackSynthesis -
Use o novo método de síntese de pilha, que pressupõe recursos de inicialização com nomes conhecidos. Requer uma inicialização moderna, mas, por sua vez, permite CI/CD via CDK Pipelines e implantações entre contas prontas para uso.
-
@aws-cdk/aws-apigateway:usagePlanKeyOrderInsensitiveId -
Se sua aplicação usa várias chaves de API do Amazon API Gateway e as associa aos planos de uso.
-
@aws-cdk/aws-rds:lowercaseDbIdentifier -
Se sua aplicação usa uma instância de banco de dados ou clusters de banco de dados do Amazon RDS e especifica explicitamente o identificador para eles.
-
@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021 -
Se a sua aplicação usar a política de segurança TLS_V1_2_2019 com distribuições do Amazon CloudFront. O CDK v2 usa a política de segurança TLSv1.2_2021 por padrão.
-
@aws-cdk/core:stackRelativeExports -
Se a sua aplicação usar várias pilhas e você se refere aos recursos de uma pilha em outra, isso determina se o caminho absoluto ou relativo é usado para criar exportações do AWS CloudFormation.
-
@aws-cdk/aws-lambda:recognizeVersionProps -
Se definido como
false, o CDK inclui metadados ao detectar se uma função do Lambda foi alterada. Isso pode causar falhas na implantação quando somente os metadados são alterados, já que versões duplicadas não são permitidas. Não há necessidade de reverter esse sinalizador se você tiver feito pelo menos uma alteração em todas as funções do Lambda em sua aplicação.
A sintaxe para reverter esses sinalizadores cdk.json é mostrada aqui.
{ "context": { "@aws-cdk/core:newStyleStackSynthesis": false, "@aws-cdk/aws-apigateway:usagePlanKeyOrderInsensitiveId": false, "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021": false, "@aws-cdk/aws-rds:lowercaseDbIdentifier": false, "@aws-cdk/core:stackRelativeExports": false, "@aws-cdk/aws-lambda:recognizeVersionProps": false } }