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

# Conceitos básicos da Biblioteca do Kit de Ferramentas CDK
<a name="toolkit-library-gs"></a>

Comece a usar a Biblioteca do Kit de Ferramentas CDK da AWS para executar programaticamente ações do CDK, como síntese e implantação, em seu código.

## Pré-requisitos
<a name="toolkit-library-gs-prerequisites"></a>

1. Versão com suporte ai Node.js instalada.

1.  Credenciais da AWS configuradas.

1. Familiaridade básica com o AWS CDK.

Para obter mais informações, consulte [Pré-requisitos do AWS CDK](prerequisites.md).

## Etapa 1: instalação da Biblioteca do Kit de Ferramentas CDK
<a name="toolkit-library-gs-install"></a>

Instale o pacote da Biblioteca do Kit de Ferramentas CDK no ambiente de desenvolvimento do seu projeto executando o seguinte:

```
npm install --save @aws-cdk/toolkit-lib
```

## Etapa 2: inicialização da Biblioteca do Kit de Ferramentas CDK
<a name="toolkit-library-gs-initialize"></a>

Crie uma instância do Kit de Ferramentas CDK para realizar ações programáticas em sua aplicação do CDK.

```
import { Toolkit } from '@aws-cdk/toolkit-lib';

const toolkit = new Toolkit({
    // Optional configuration options go here
});
```

É possível personalizar a instância do Kit de Ferramentas CDK durante a criação. Para obter instruções, consulte [Configuração da sua instância do Kit de Ferramentas CDK](toolkit-library-configure.md).

## Etapa 3: criação de uma fonte de conjunto de nuvem para sua aplicação do CDK
<a name="toolkit-library-gs-ca"></a>

Uma fonte de conjunto de nuvem fornece instruções para gerar modelos do CloudFormation a partir da sua aplicação do CDK. É possível criar uma de várias maneiras. Veja a seguir alguns exemplos:

1.  **Uma função de compilação de conjunto em linha**:

   ```
   import * as cdk from 'aws-cdk-lib';
   
   const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => {
     const app = new cdk.App();
     new MyStack(app, 'MyStack');
     return app.synth();
   });
   ```

1.  **Um arquivo de aplicação do CDK existente**:

   ```
   const cloudAssemblySource = await toolkit.fromCdkApp("ts-node app.ts");
   ```

Para obter mais informações, consulte [Configuração de fontes de conjunto de nuvem](toolkit-library-configure-ca.md).

## Etapa 4: definição de ações programáticas para sua aplicação do CDK
<a name="toolkit-library-gs-define"></a>

Agora que você criou uma instância do Kit de Ferramentas CDK e uma fonte de conjunto de nuvem, pode começar a definir ações programáticas. Veja a seguir um exemplo básico de como criar uma implantação da pilha `MyStack`:

```
import { StackSelectionStrategy } from '@aws-cdk/toolkit-lib';

await toolkit.deploy(cloudAssemblySource, {
  stacks: {
    strategy: StackSelectionStrategy.PATTERN_MUST_MATCH, // Deploy only stacks that exactly match the provided patterns
    patterns: ["MyStack"],
  },
});
```

## Etapa 5: personalização adicional do Kit de Ferramentas CDK
<a name="toolkit-library-gs-customize"></a>

É possível configurar e personalizar ainda mais o Kit de Ferramentas CDK de acordo com suas necessidades:
+  **Mensagens e interações**: configure como o Kit de Ferramentas CDK se comunica com usuários e aplicações. Consulte [Configuração de mensagens e interações](toolkit-library-configure-messages.md).
+  **Tratamento de erros**: implemente o tratamento estruturado de erros para operações do CDK. Consulte [Configuração do tratamento de erros](toolkit-library-configure.md#toolkit-library-configure-errors).

## Recursos adicionais
<a name="toolkit-library-gs-resources"></a>

Para obter mais informações sobre o pacote `npm` da Biblioteca do Kit de Ferramentas CDK, consulte o arquivo [ReadMe](https://www.npmjs.com/package/@aws-cdk/toolkit-lib) no pacote `npm` *@aws-cdk/toolkit-lib*.

Para obter informações de referência de API, consulte a [referência de API da Biblioteca do Kit de Ferramentas CDK](https://docs.aws.amazon.com/cdk/api/toolkit-lib/).