Este é o Guia do desenvolvedor do 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á.

# Execute ações programáticas usando a Biblioteca do Kit de Ferramentas CDK
<a name="toolkit-library"></a>

## Noções básicas da Biblioteca do Kit de Ferramentas CDK
<a name="toolkit-library-intro"></a>

A Biblioteca do Kit de Ferramentas CDK permite que você execute ações do CDK programaticamente, por meio de código, em vez de usar comandos da CLI. É possível usar essa biblioteca para criar ferramentas personalizadas, criar aplicações da CLI especializadas e integrar recursos do CDK em seus fluxos de trabalho de desenvolvimento.

 **Gerencie o ciclo de vida da sua infraestrutura com controle programático**   
A Biblioteca do Kit de Ferramentas CDK fornece interfaces programáticas para as ações do CDK a seguir:  
+  **Síntese**: gera modelos e artefatos de implantação do AWS CloudFormation.
+  **Implantação**: provisiona ou atualiza a infraestrutura usando modelos do CloudFormation.
+  **Refatorar**: preserva os recursos implantados ao refatorar o código CDK, como renomear constructos ou movê-los entre pilhas.
+  **Listar**: visualiza informações sobre pilhas e suas dependências.
+  **Assistir**: monitora as aplicações do CDK em busca de mudanças locais.
+  **Reverter**: retorna as pilhas ao seu último estado estável.
+  **Destruir**: remove pilhas do CDK e recursos associados.

 **Melhore e personalize seu gerenciamento de infraestrutura**   
+  **Controle por meio de código**: integre o gerenciamento da infraestrutura diretamente em suas aplicações e crie pipelines de implantação responsivos.
+  **Gerenciamento de conjuntos de nuvem**: crie, inspecione e transforme suas definições de infraestrutura antes da implantação.
+  **Personalização de implantações**: configure parâmetros, comportamento de reversão e monitoramento para atender às suas necessidades.
+  **Preservação de recursos durante a refatoração**: detecte e preserve recursos automaticamente ao refatorar o código do CDK.
+  **Tratamento de erros com precisão**: implemente o tratamento estruturado de erros com informações detalhadas de diagnóstico.
+  **Personalize as comunicações**: configure indicadores de andamento e logs personalizados por meio de implementações do `IoHost`.
+  **Conecte-se com a AWS**: configure perfis, regiões e fluxos de autenticação programaticamente.

## Escolha de quando usar a Biblioteca do Kit de Ferramentas CDK
<a name="toolkit-library-intro-when"></a>

A Biblioteca do Kit de Ferramentas CDK é particularmente valiosa quando você precisa:
+ Automatizar as implantações de infraestrutura como parte dos pipelines de CI/CD.
+ Criar ferramentas de implantação personalizadas de acordo com as necessidades da sua organização.
+ Integrar as ações do CDK em aplicações ou plataformas existentes.
+ Criar fluxos de trabalho de implantação especializados com etapas personalizadas de validação ou aprovação.
+ Implementar padrões avançados de gerenciamento de infraestrutura em vários ambientes.
+ Automatizar as operações de refatoração para preservar recursos ao refatorar o código do CDK.

## Usar a Biblioteca do Kit de Ferramentas CDK
<a name="toolkit-library-intro-example"></a>

O exemplo a seguir mostra como criar e implantar um bucket do S3 simples usando a Biblioteca do Kit de Ferramentas CDK:

```
// Import required packages
import { Toolkit } from '@aws-cdk/toolkit-lib';
import { App, Stack } from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';

// Create and configure the CDK Toolkit
const toolkit = new Toolkit();

// Create a cloud assembly source with an inline app
const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => {
   const app = new App();
   const stack = new Stack(app, 'SimpleStorageStack');

   // Create an S3 bucket in the stack
   new s3.Bucket(stack, 'MyFirstBucket', {
      versioned: true
   });

   return app.synth();
});

// Deploy the stack
await toolkit.deploy(cloudAssemblySource);
```

 **O que posso fazer agora?**   
+  **Automatizar implantações**: acione implantações programaticamente e adicione etapas pré/pós-implantação.
+  **Integrar a sistemas**: conecte-se com fluxos de trabalho de CI/CD, ferramentas personalizadas e soluções de monitoramento.
+  **Controlar os detalhes da implantação**: configure opções refinadas para seleção de pilhas e implantações em vários ambientes.
+  **Aumentar a confiabilidade**: implemente o tratamento de erros pronto para a produção e o acompanhamento do andamento da implantação.
+  **Automatizar a refatoração**: detecte e preserve recursos ao refatorar o código do CDK.

## Próximas etapas
<a name="toolkit-library-intro-next"></a>

Para começar a usar a Biblioteca do Kit de Ferramentas CDK, consulte [Conceitos básicos da Biblioteca do Kit de Ferramentas CDK](toolkit-library-gs.md).

## Saiba mais
<a name="toolkit-library-intro-learn"></a>

Para saber mais sobre a Biblioteca do Kit de Ferramentas CDK, consulte:
+  Arquivo [ReadMe](https://www.npmjs.com/package/@aws-cdk/toolkit-lib) no pacote `npm` *@aws-cdk/toolkit-lib*.
+  [Referência de API da Biblioteca do Kit de Ferramentas CDK da AWS](https://docs.aws.amazon.com/cdk/api/toolkit-lib/).