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

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) instalando e configurando a interface de linha de AWS CDK comando (AWS CDK CLI). Em seguida, use o CDK CLI para criar seu primeiro CDK aplicativo, inicializar seu AWS ambiente e implantar seu aplicativo.

Pré-requisitos

Antes de começar a usar o AWS CDK, preencha todos os pré-requisitos. Esses pré-requisitos são necessários para aqueles que são novatos AWS ou iniciantes em programação. Para obter instruções, consulte AWS CDK pré-requisitos.

Recomendamos que você tenha uma compreensão básica do que AWS CDK é. Para ter mais informações, consulte O que é o AWS CDK? e Aprenda os AWS CDK principais conceitos.

Instale o AWS CDK CLI

Use o Node Package Manager para instalar CDK CLI o. 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 CDK projetos individuais. Para fazer isso, remova a -g opção do npm install comando. Em seguida, use npx aws-cdk para invocar o. CDK CLI Isso executará uma versão local, se ela existir. Caso contrário, a versão instalada globalmente será usada.

Solucionar problemas de uma instalação CDK CLI

Se você receber um erro de permissão e tiver acesso de administrador em seu sistema, execute o seguinte:

$ sudo npm install -g aws-cdk

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

$ npm uninstall -g aws-cdk

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

Verifique se a CDK CLI instalação foi bem-sucedida

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

Configurar o AWS CDKCLI

Depois de instalar o CDKCLI, você pode começar a usá-lo para desenvolver aplicativos em sua máquina local. Para interagir com AWS, por exemplo, implantar aplicativos, você deve ter credenciais de segurança configuradas em sua máquina local com permissões para realizar qualquer ação que você iniciar.

Para configurar as credenciais de segurança em sua máquina local, você usa o. AWS CLI A forma como você configura as credenciais de segurança depende de como você gerencia os usuários. Para obter instruções, consulte Autenticação e credenciais de acesso no Guia do AWS Command Line Interface usuário.

Eles CDK CLI usarão automaticamente as credenciais de segurança que você configura com o. AWS CLI Por exemplo, se você for um usuário do IAM Identity Center, poderá usar o aws configure sso comando para configurar as credenciais de segurança. Se você for um IAM usuário, poderá usar o aws configure comando. AWS CLI Isso o guiará na configuração das credenciais de segurança em sua máquina local e salvará as informações necessárias em seus arquivos config e. credentials Então, ao usar o CDKCLI, como implantar um aplicativo comcdk deploy, o CDK CLI usará suas credenciais de segurança configuradas.

Assim como o AWS CLI, o CDK CLI usará seu default perfil por padrão. Você pode especificar um perfil usando a CDK CLI --profile opção. Para obter mais informações sobre o uso de credenciais de segurança com o CDKCLI, consulteConfigure as credenciais de segurança para o AWS CDKCLI.

(Opcional) Instale 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 CDK aplicativo. Para obter instruções, consulte:

Crie seu primeiro CDK aplicativo

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