Começando com o AWS CDK - AWS Cloud Development Kit (AWS CDK) v2

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

Começando com o AWS CDK

Comece com o AWS Cloud Development Kit (AWS CDK) criando um Conta da AWS, configurando a interface de linha de AWS CDK comando (AWS CDK CLI) e criando seu primeiro aplicativo CDK.

Pré-requisitos

Antes de começar a usar o AWS CDK, recomendamos que você tenha uma compreensão básica do que AWS CDK é. Para obter mais informações, consulte O que é o AWS CDK? e Aprenda os AWS CDK principais conceitos.

Etapa 1: criar um Conta da AWS usuário administrativo

Se você ou sua organização são novatos AWS, você deve se inscrever Conta da AWS e criar um usuário administrativo. Para obter instruções, consulte Como configurar com o IAM no Guia do usuário do IAM.

Você pode gerenciar o IAM usando métodos diferentes, como por meio do AWS console, do AWS Command Line Interface (AWS CLI) ou por meio de interfaces de aplicativos (APIs) no associadoSDKs. Ao usar o IAM com o AWS CDK CLI, você usará principalmente o AWS CLI para configurar e gerenciar credenciais de segurança. Para saber mais, consulte AWS Command Line Interface (CLI) e Kits de desenvolvimento de software (SDKs) no Guia do usuário do IAM.

Depois de criar um usuário administrativo, você pode começar a usar o AWS CDK instalando o CDKCLI. No entanto, recomendamos que você determine primeiro seu método de gerenciamento de usuários, seguindo a prática recomendada do IAM de aplicar permissões de privilégios mínimos. Em vez de usar seu usuário administrativo para tudo, você cria usuários do IAM e concede somente as permissões necessárias para realizar uma tarefa.

Etapa 2: Determine seu método de gerenciamento de usuários

Depois de criar seu Conta da AWS usuário administrativo, você desejará determinar seu método de gerenciamento de usuários. Para saber mais sobre os diferentes métodos de gerenciamento de usuários, consulte Visão geral do gerenciamento de AWS identidades: usuários no Guia do usuário do IAM.

Se sua organização tiver um método de gerenciamento de usuários, siga as orientações deles. Caso contrário, recomendamos usar AWS IAM Identity Center para criar e gerenciar usuários. Com o IAM Identity Center, você pode gerenciar Contas da AWS usuários e permissões a partir de um serviço gerenciado centralmente. Você também pode usar um provedor de identidade para autenticar usuários e fornecer credenciais temporárias para uso com o CDK. CLI Essa é uma prática recomendada de segurança do IAM. Para uma introdução ao IAM Identity Center, consulte O que é o IAM Identity Center? no Guia do AWS IAM Identity Center usuário.

Como usuário, você precisa configurar as credenciais de segurança em seu ambiente de desenvolvimento local para o CLI CDK. Recomendamos que você use install e use o AWS Command Line Interface (AWS CLI) para fazer isso.

Etapa 3: instalar o AWS CLI

Como usuário, você usa o AWS CLI para criar e gerenciar arquivos de configuração e credenciais em sua máquina local. Esses arquivos são usados para armazenar, gerenciar e gerar credenciais de segurança para uso com o CLI CDK.

Para instalar o AWS CLI, consulte Instalar ou atualizar para a versão mais recente do AWS CLI no Guia do AWS Command Line Interface Usuário.

Para saber mais sobre esses arquivos, consulte Configurações e configurações do arquivo de credenciais no Guia do AWS Command Line Interface usuário.

Depois de instalar o AWS CLI, você configurará as credenciais de segurança em uma etapa posterior.

Etapa 4: Pré-requisitos da linguagem de programação Node.js e instalação

Todos os AWS CDK desenvolvedores, independentemente da linguagem de programação compatível que você usará, exigem a versão Node.js14.15.0 ou posterior. Todas as linguagens de programação suportadas usam o mesmo back-end, que é executado emNode.js. Recomendamos uma versão com suporte ativo de longo prazo. Se sua organização tiver uma recomendação diferente, siga as orientações dela.

Importante

As versões 13.0.0 a 13.6.0 do Node.js não são compatíveis com o AWS CDK devido a problemas de compatibilidade com suas dependências.

Outros pré-requisitos da linguagem de programação dependem da linguagem que você usará para desenvolver aplicativos: AWS CDK

TypeScript
  • TypeScript 3.8 ou posterior () npm -g install typescript

JavaScript

Sem requisitos adicionais

Python
  • Python 3.7 ou posterior, incluindo e pip virtualenv

Java
  • Java Development Kit (JDK) 8 (também conhecido como 1.8) ou posterior

  • Apache Maven 3.5 ou posterior

O Java IDE é recomendado (usamos o Eclipse em alguns exemplos neste guia). O IDE deve ser capaz de importar projetos Maven. Verifique se o seu projeto está configurado para usar o Java 1.8. Defina a variável de ambiente JAVA_HOME para o caminho em que você instalou o JDK.

C#

.NET Core 3.1 ou posterior, ou.NET 6.0 ou posterior.

Recomenda-se o Visual Studio 2019 (qualquer edição) ou o Visual Studio Code.

Go

Vá para a versão 1.1.8 ou posterior.

Para obter informações mais detalhadas, consulte a seção Pré-requisitos do seu idioma:

Suspensão de uso de linguagem de terceiros

Cada versão de idioma só é suportada até o fim da vida útil e está sujeita a alterações mediante aviso prévio. EOL

Etapa 5: instalar o AWS CDKCLI

Use o Node Package Manager para instalar o CDK. CLI Recomendamos que você o instale globalmente usando o seguinte comando:

$ npm install -g aws-cdk

Para instalar uma versão específica do CDKCLI, use a seguinte estrutura de comando:

$ npm install -g aws-cdk@X.YY.Z

Se você quiser usar várias versões do AWS CDK, considere instalar uma versão correspondente do CDK CLI em projetos individuais do CDK. Para fazer isso, remova a -g opção do npm install comando. Em seguida, use npx aws-cdk para invocar o CLI CDK. Isso executará uma versão local, se ela existir. Caso contrário, a versão instalada globalmente será usada.

nota

Se você receber um erro de permissão e tiver acesso de administrador em seu sistema, tentesudo npm install -g aws-cdk.

Execute o comando a seguir para verificar se a instalação foi bem-sucedida. O AWS CDK CLI deve gerar o número da versão:

$ cdk --version

Se você receber uma mensagem de erro, tente desinstalar o AWS CDK CLI executando o seguinte:

$ npm uninstall -g aws-cdk

Em seguida, repita as etapas para reinstalar o. AWS CDK CLI

Etapa 6: Configurar as credenciais de segurança para o CDK CLI

Ao desenvolver com o AWS CDK em seu ambiente local, você usará principalmente o CDK CLI para interagir com AWS. Essas interações incluem a implantação de pilhas de CDK, a realização de diferenças de pilhas, a importação de recursos para a CDK e muito mais.

Para realizar essas ações, você deve configurar as credenciais de segurança para o CDK CLI em sua máquina local. Isso permite AWS saber quem você é e quais permissões você tem. Para obter orientações, consulte Configure as credenciais de segurança para o AWS CDKCLI.

Etapa 7: inicialize seu ambiente AWS

As pilhas de CDK são implantadas em ambientes. AWS Antes de implantar uma pilha de CDK em um ambiente, o ambiente deve primeiro ser inicializado.

Para inicializar seu ambiente, use o comando CDK. CLI cdk bootstrap Para obter instruções, consulte Como inicializar seu ambiente.

Etapa 8: (opcional) instalar AWS CDK ferramentas adicionais

AWS Toolkit for Visual Studio CodeÉ um plug-in de código aberto para o Visual Studio Code que ajuda você a criar, depurar e implantar aplicativos no. AWS O kit de ferramentas fornece uma experiência integrada para o desenvolvimento de AWS CDK aplicativos. Ele inclui o recurso AWS CDK Explorer para listar seus AWS CDK projetos e navegar pelos vários componentes do aplicativo CDK. Para obter instruções, consulte:

Etapa 9: Crie seu primeiro aplicativo CDK

Agora você está pronto para começar a usar o AWS CDK criando seu primeiro aplicativo CDK. Para obter instruções, consulte Tutorial: Crie seu primeiro AWS CDK aplicativo.