Conceitos básicos da Biblioteca do Kit de Ferramentas CDK - AWS Kit de desenvolvimento em nuvem (AWS CDK) v2
Pré-requisitosEtapa 1: instalação da Biblioteca do Kit de Ferramentas CDKEtapa 2: inicialização da Biblioteca do Kit de Ferramentas CDKEtapa 3: criação de uma fonte de conjunto de nuvem para sua aplicação do CDKEtapa 4: definição de ações programáticas para sua aplicação do CDKEtapa 5: personalização adicional do Kit de Ferramentas CDKRecursos adicionais

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

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

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

  2. Credenciais da AWS configuradas.

  3. Familiaridade básica com o AWS CDK.

Para obter mais informações, consulte Pré-requisitos do AWS CDK.

Etapa 1: instalação da Biblioteca do Kit de Ferramentas CDK

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

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.

Etapa 3: criação de uma fonte de conjunto de nuvem para sua aplicação do CDK

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();
});

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

Etapa 4: definição de ações programáticas para sua aplicação do CDK

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

É possível configurar e personalizar ainda mais o Kit de Ferramentas CDK de acordo com suas necessidades:

Recursos adicionais

Para obter mais informações sobre o pacote npm da Biblioteca do Kit de Ferramentas CDK, consulte o arquivo ReadMe 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.