Introdução à CDK Toolkit Library - AWS Kit de desenvolvimento em nuvem (AWS CDK) v2
Pré-requisitosEtapa 1: Instalando a biblioteca do CDK ToolkitEtapa 2: Inicializando a biblioteca do CDK ToolkitEtapa 3: Criar uma fonte de montagem em nuvem para seu aplicativo CDKEtapa 4: Definindo ações programáticas para seu aplicativo CDKEtapa 5: Personalizando ainda mais o CDK ToolkitRecursos 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á.

Introdução à CDK Toolkit Library

Comece a usar a AWS CDK Toolkit Library para executar programaticamente ações de CDK, como síntese e implantação, em seu código.

Pré-requisitos

  1. Versão compatível do Node.js instalada.

  2. AWS credenciais configuradas.

  3. Familiaridade básica com o AWS CDK.

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

Etapa 1: Instalando a biblioteca do CDK Toolkit

Instale o pacote CDK Toolkit Library no ambiente de desenvolvimento do seu projeto executando o seguinte:

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

Etapa 2: Inicializando a biblioteca do CDK Toolkit

Crie uma instância do CDK Toolkit para realizar ações programáticas em seu aplicativo CDK.

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

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

Você pode personalizar a instância do CDK Toolkit durante a criação. Para obter instruções, consulte Configurar sua instância do CDK Toolkit.

Etapa 3: Criar uma fonte de montagem em nuvem para seu aplicativo CDK

Uma fonte de montagem na nuvem fornece instruções para gerar CloudFormation modelos a partir do seu aplicativo CDK. Você pode criar um de várias maneiras. Veja a seguir alguns exemplos:

  1. Uma função de construção de montagem 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 aplicativo CDK existente:

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

Para obter mais informações, consulte Configurar fontes de montagem em nuvem.

Etapa 4: Definindo ações programáticas para seu aplicativo CDK

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

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: Personalizando ainda mais o CDK Toolkit

Você pode configurar e personalizar ainda mais o CDK Toolkit de acordo com suas necessidades:

Recursos adicionais

Para obter mais informações sobre o pacote CDK Toolkit Library, consulte o npm ReadMepacote @aws npm -cdk/toolkit-lib.

Para obter informações de referência da API, consulte a referência da API da CDK Toolkit Library.