Inicializar uma aplicação AWS CDK com um fluxo de trabalho - Amazon CodeCatalyst
Quando usar a ação “Inicialização do AWS CDK”Como funciona a ação “Inicialização do AWS CDK”Versões da CLI do CDK usadas pela ação “Inicialização do AWS CDK”Imagem de runtime usada pela ação “Inicialização do AWS CDK”

Inicializar uma aplicação AWS CDK com um fluxo de trabalho

Esta seção descreve como inicializar uma aplicação AWS CDK usando um fluxo de trabalho do CodeCatalyst. Para fazer isso, você deve adicionar a ação Inicialização do AWS CDK ao seu fluxo de trabalho. A ação Inicialização do AWS CDK provisiona uma pilha de inicialização no ambiente da AWS usando o modelo moderno. Se já existir uma pilha de inicialização, a ação a atualizará, se necessário. Ter uma pilha de inicialização presente na AWS é um pré-requisito para implantar uma aplicação AWS CDK.

Para ter mais informações sobre inicialização, consulte Inicialização no Guia do desenvolvedor do AWS Cloud Development Kit (AWS CDK).

Tópicos

Quando usar a ação “Inicialização do AWS CDK”

Use essa ação se você tiver um fluxo de trabalho que implanta uma aplicação AWS CDK e quiser implantar (e atualizar, se necessário) a pilha de inicialização ao mesmo tempo. Nesse caso, você adicionaria a ação Inicialização do AWS CDK ao mesmo fluxo de trabalho que implanta a aplicação AWS CDK.

Não use essa ação se uma das seguintes opções se aplicar:

  • Você já implantou uma pilha de inicialização usando outro mecanismo e deseja mantê-la intacta (sem atualizações).

  • Você quer usar um modelo de inicialização personalizado, que não é compatível com a ação Inicialização do AWS CDK.

Como funciona a ação “Inicialização do AWS CDK”

A Inicialização do AWS CDK funciona da seguinte maneira:

  1. Em runtime, se você especificou a versão 1.0.7 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 criação do CodeCatalyst.

    Se você especificou a versão 1.0.8 ou posterior, a ação vem junto com uma versão específica da CLI do CDK e, portanto, nenhum download ocorre.

  2. A ação usa a CLI do CDK para executar o comando cdk bootstrap. Esse comando executa as tarefas de inicialização descritas no tópico Inicialização no Guia do desenvolvedor do AWS Cloud Development Kit (AWS CDK).

Versões da CLI do CDK usadas pela ação “Inicializaçã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 Inicialização do AWS CDK.

nota

Talvez você consiga substituir o padrão. Para ter mais informações, consulte CdkCliVersion no YAML da ação “Inicialização do AWS CDK”.

versão de ação “Inicialização do AWS CDK” Versão da CLI do AWS CDK

1.0.0 – 1.0.7

mais recente

1.0.8 ou posterior

2.99.1

Imagem de runtime usada pela ação “Inicializaçã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 Inicializaçã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 Inicializaçã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-bootstrap@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 de ação “Inicialização do AWS CDK” Imagens de ambiente de runtime

1.x

Imagens de novembro de 2022

2.x

Imagens de março de 2024