A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

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á.

# Implantando um AWS CDK aplicativo com um fluxo de trabalho
<a name="cdk-dep-action"></a>

Esta seção descreve como implantar um AWS Cloud Development Kit (AWS CDK) aplicativo em sua AWS conta 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 de **AWS CDK implantação** sintetiza e implanta seu AWS Cloud Development Kit (AWS CDK) aplicativo em. AWS Se seu aplicativo já existir em AWS, a ação o atualizará, se necessário. 

Para obter informações gerais sobre como criar aplicativos usando o AWS CDK, consulte [O que é o AWS CDK?](https://docs.aws.amazon.com/cdk/v2/guide/home.html) no *Guia do AWS Cloud Development Kit (AWS CDK) desenvolvedor*.

**Topics**
+ [Quando usar a ação 'AWS CDK implantar'](#cdk-dep-action-when-to-use)
+ [Como a ação 'AWS CDK implantar' funciona](#cdk-dep-action-how-it-works)
+ [Versões da CLI do CDK usadas pela ação 'implantar'AWS CDK](#cdk-dep-action-cdk-version)
+ [Imagem de tempo de execução usada pela ação 'AWS CDK implantar'](#cdk-dep-action-runtime)
+ [Quantas pilhas a ação pode implantar?](#cdk-dep-action-how-many-stacks)
+ [Exemplo: implantação de um aplicativo AWS CDK](cdk-dep-action-example-workflow.md)
+ [Adicionando a ação 'AWS CDK implantar'](cdk-dep-action-add.md)
+ [Variáveis de “Implantação do AWS CDK ”](cdk-dep-action-variables.md)
+ [YAML da ação “Implantação do AWS CDK ”](cdk-dep-action-ref.md)

## Quando usar a ação 'AWS CDK implantar'
<a name="cdk-dep-action-when-to-use"></a>

Use essa ação se você desenvolveu um aplicativo usando o AWS CDK e agora deseja implantá-lo automaticamente como parte do fluxo de trabalho de integração e entrega contínuas automatizadas (CI/CD). Por exemplo, talvez você queira implantar seu AWS CDK aplicativo automaticamente sempre que alguém mesclar uma pull request relacionada à fonte do seu AWS CDK aplicativo. 

## Como a ação 'AWS CDK implantar' funciona
<a name="cdk-dep-action-how-it-works"></a>

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

1. [Em tempo de execução, se você especificou a versão 1.0.12 ou anterior da ação, a ação baixará a CLI CDK mais recente (também chamada de Tookit) para a imagem AWS CDK do ambiente de tempo de execução. CodeCatalyst ](#cdk-dep-action-runtime)

   Se você especificou a versão 1.0.13 ou posterior, a ação vem junto com uma [versão específica](#cdk-dep-action-cdk-version) da CLI do CDK e, portanto, nenhum download ocorre.

1. A ação usa a CLI do CDK para executar o comando `cdk deploy`. Esse comando sintetiza e implanta seu AWS CDK aplicativo em. AWS Para ter mais informações sobre esse comando, consulte o tópico [Kit de ferramentas do AWS CDK (comando cdk)](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) no *Guia do desenvolvedor do AWS Cloud Development Kit (AWS CDK) *.

## Versões da CLI do CDK usadas pela ação 'implantar'AWS CDK
<a name="cdk-dep-action-cdk-version"></a>

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](cdk-dep-action-ref.md#cdk.dep.cdk.cli.version) no [YAML da ação “Implantação do AWS CDK ”](cdk-dep-action-ref.md).


| Versão da ação “Implantação do AWS CDK ” | AWS CDK Versão CLI | 
| --- | --- | 
|  1.0.0 – 1.0.12  |  mais recente  | 
|  1.0.13 ou posterior  |  2.99.1  | 

## Imagem de tempo de execução usada pela ação 'AWS CDK implantar'
<a name="cdk-dep-action-runtime"></a>

A tabela a seguir mostra as imagens do ambiente de execução CodeCatalyst usadas para executar diferentes versões da ação de **AWS CDK implantação**. As imagens incluem diferentes conjuntos de ferramentas pré-instaladas. Para obter mais informações, consulte [Imagens ativas](build-images.md#build-curated-images).

**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 obter mais informações, consulte [YAML da ação “Implantação do AWS CDK ”](cdk-dep-action-ref.md). 


| 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 name="cdk-dep-action-how-many-stacks"></a>

A **Implantação do AWS CDK ** pode implantar somente uma única pilha. Se seu AWS CDK aplicativo consistir em várias pilhas, você deverá criar uma pilha principal com pilhas aninhadas e implantar a principal usando essa ação.