Implantar uma aplicação AWS CDK com um fluxo de trabalho
Esta seção descreve como implantar uma aplicação AWS Cloud Development Kit (AWS CDK) em sua conta da AWS usando um fluxo de trabalho. Para fazer isso, você deve adicionar a ação Implantação do AWS CDK ao seu fluxo de trabalho. A ação Implantação do AWS CDK sintetiza e implanta a aplicação AWS Cloud Development Kit (AWS CDK) na AWS. Se já existir um aplicativo na AWS, a ação o atualizará, se necessário.
Para ter informações gerais sobre como criar aplicações usando o AWS CDK, consulte O que é o AWS CDK? no Guia do desenvolvedor do AWS Cloud Development Kit (AWS CDK).
Tópicos
- Quando usar a ação “Implantação do AWS CDK”
- Como a ação “Implantação do AWS CDK” funciona
- Versões da CLI do CDK usadas pela ação “Implantação do AWS CDK”
- Imagem de runtime usada pela ação “Implantação do AWS CDK”
- Quantas pilhas a ação pode implantar?
- Exemplo: implantação de uma aplicação AWS CDK
- Adicionar a ação “Implantação do AWS CDK”
- Variáveis de “Implantação do AWS CDK”
- YAML da ação “Implantação do AWS CDK”
Quando usar a ação “Implantação do AWS CDK”
Use essa ação se você desenvolveu uma aplicação usando o AWS CDK e agora deseja implantá-lo automaticamente como parte do fluxo de trabalho automatizado de integração e entrega contínuas (CI/CD). Por exemplo, talvez você queira implantar a aplicação AWS CDK sempre que alguém mesclar uma solicitação pull relacionada à origem da aplicação AWS CDK.
Como a ação “Implantação do AWS CDK” funciona
A Implantação do AWS CDK funciona da seguinte maneira:
-
Em runtime, se você especificou a versão 1.0.12 ou anterior da ação, a ação baixará a CLI mais recente do CDK (também chamada de AWS CDK Tookit) para a imagem de ambiente de runtime do CodeCatalyst.
Se você especificou a versão 1.0.13 ou posterior, a ação vem junto com uma versão específica da CLI do CDK e, portanto, nenhum download ocorre.
-
A ação usa a CLI do CDK para executar o comando
cdk deploy. Esse comando sintetiza e implanta a aplicação AWS CDK na AWS. Para ter mais informações sobre esse comando, consulte o tópico Kit de ferramentas do AWS CDK (comando cdk) no Guia do desenvolvedor do AWS Cloud Development Kit (AWS CDK).
Versões da CLI do CDK usadas pela ação “Implantação do AWS CDK”
A tabela a seguir mostra qual versão da CLI do CDK é usada por padrão por diferentes versões da ação Implantação do AWS CDK.
nota
Talvez você consiga substituir o padrão. Para ter mais informações, consulte CdkCliVersion no YAML da ação “Implantação do AWS CDK”.
| Versão da ação “Implantação do AWS CDK” | Versão da CLI do AWS CDK |
|---|---|
|
1.0.0 – 1.0.12 |
mais recente |
|
1.0.13 ou posterior |
2.99.1 |
Imagem de runtime usada pela ação “Implantação do AWS CDK”
A tabela a seguir mostra as imagens do ambiente de runtime que o CodeCatalyst usa para executar diferentes versões da ação Implantação do AWS CDK. As imagens incluem diferentes conjuntos de ferramentas pré-instaladas. Para ter mais informações, consulte Imagens ativas.
nota
Recomendamos atualizar sua ação Implantação do AWS CDK para a versão 2.x para aproveitar as ferramentas mais recentes disponíveis na imagem de março de 2024. Para atualizar a ação, defina a propriedade Identifier como aws/cdk-deploy@v2 no arquivo de definição de fluxo de trabalho. Para ter mais informações, consulte YAML da ação “Implantação do AWS CDK”.
| Versão da ação “Implantação do AWS CDK” | Imagens de ambiente de runtime |
|---|---|
|
1.x |
Imagens de novembro de 2022 |
|
2.x |
Imagens de março de 2024 |
Quantas pilhas a ação pode implantar?
A Implantação do AWS CDK pode implantar somente uma única pilha. Se a aplicação AWS CDK consistir em várias pilhas, você deverá criar uma pilha principal com pilhas aninhadas e implantar a principal usando essa ação.
