Parâmetros e o AWS CDK - AWS Cloud Development Kit (AWS CDK) v2

Este é o Guia do Desenvolvedor AWS CDK v2. A versão CDK 1 mais antiga 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á.

Parâmetros e o AWS CDK

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 os 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 AWS CDK aplicativos são valores de contexto e variáveis de ambiente. Como eles 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 seu CDK aplicativo.

nota

Para controlar o fluxo com parâmetros, você pode usar CfnConditionconstruções, embora isso seja estranho em comparação com declarações nativas. if

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 seu CDK aplicativo aceite as informações necessárias de uma forma bem definida e as use diretamente para declarar construções em seu aplicativo. 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 obter instruções sobre o desenvolvimento de CDK aplicativos com parâmetros, consulteUse CloudFormation parâmetros para obter um CloudFormation valor.