Este é o Guia do Desenvolvedor AWS CDK v2. A versão CDK 1 mais antiga 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.js
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
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
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.