Execute ações programáticas usando a Biblioteca do Kit de Ferramentas CDK - AWS Kit de desenvolvimento em nuvem (AWS CDK) v2
Noções básicas da Biblioteca do Kit de Ferramentas CDKEscolha de quando usar a Biblioteca do Kit de Ferramentas CDKUsar a Biblioteca do Kit de Ferramentas CDKPróximas etapasSaiba mais

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

Noções básicas da Biblioteca do Kit de Ferramentas CDK

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

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

Para começar a usar a Biblioteca do Kit de Ferramentas CDK, consulte Conceitos básicos da Biblioteca do Kit de Ferramentas CDK.

Saiba mais

Para saber mais sobre a Biblioteca do Kit de Ferramentas CDK, consulte: