Este é o Guia do Desenvolvedor 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á.
Os parâmetros são valores personalizados fornecidos no momento da implantação. Os parâmetros são uma característica do AWS CloudFormation. Como AWS Cloud Development Kit (AWS CDK) sintetiza AWS CloudFormation modelos, ele também oferece suporte para parâmetros de tempo de implantação.
Sobre parâmetros
Usando o AWS CDK, você pode definir parâmetros, que podem ser usados nas propriedades das construções que você cria. Você também pode implantar pilhas que contenham parâmetros.
Ao implantar o AWS CloudFormation modelo usando o AWS CDK CLI, você fornece os valores dos parâmetros na linha de comando. Se você implantar o modelo por meio do AWS CloudFormation console, você será solicitado a fornecer os valores dos parâmetros.
Em geral, não recomendamos o uso de AWS CloudFormation parâmetros com AWS CDK o. As formas usuais de passar valores para aplicações AWS CDK são valores de contexto e variáveis de ambiente. Como não estão disponíveis no momento da síntese, os valores dos parâmetros não podem ser facilmente usados para controle de fluxo e outras finalidades em sua aplicação CDK.
nota
Para controlar o fluxo com parâmetros, você pode usar constructos CfnCondition
, embora isso seja estranho em comparação com declarações if
nativas.
O uso de parâmetros exige que você esteja ciente de como o código que você está escrevendo se comporta no momento da implantação e também no momento da síntese. Isso torna mais difícil entender e raciocinar sobre sua AWS CDK inscrição, em muitos casos com poucos benefícios.
Geralmente, é melhor que sua aplicação CDK aceite as informações necessárias de uma forma bem definida e as use diretamente para declarar constructos em sua aplicação CDK. Um AWS CloudFormation modelo ideal AWS CDK gerado é concreto, sem valores a serem especificados no momento da implantação.
No entanto, existem casos de uso para AWS CloudFormation os quais os parâmetros são exclusivamente adequados. Se você tiver equipes separadas definindo e implantando a infraestrutura, por exemplo, você pode usar parâmetros para tornar os modelos gerados mais amplamente úteis. Além disso, como o AWS CDK suporta AWS CloudFormation parâmetros, você pode usá-lo AWS CDK com AWS serviços que usam AWS CloudFormation modelos (como Service Catalog). Esses AWS serviços usam parâmetros para configurar o modelo que está sendo implantado.
Saiba mais
Para instruções sobre o desenvolvimento de aplicações CDK com parâmetros, consulte Use CloudFormation parâmetros para obter um CloudFormation valor.