Este é o Guia do Desenvolvedor AWS CDK v2. A CDK v1 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á.
Conceitos básicos da AWS CDK
Comece com o AWS Cloud Development Kit (AWS CDK) instalando e configurando a interface da linha de comandos do AWS CDK (AWS CDK CLI). Em seguida, use o CDK CLI para criar seu primeiro aplicativo CDK, inicializar seu ambiente AWS e implantar seu aplicativo.
Pré-requisitos
Antes de começar com o AWS CDK, conclua todos os pré-requisitos. Esses pré-requisitos são necessários para aqueles que são novatos no AWS ou iniciantes em programação. Para instruções, consulte Pré-requisitos da AWS CDK.
Recomendamos que você tenha uma compreensão básica do que é o 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
Para instalar os módulos, use o gerenciador de pacotes Node 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 CDK CLI, 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 opção -g do comando npm install. 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.
Solução de 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 instalação do CDK CLI foi bem-sucedida
Execute os comandos a seguir para verificar se a instalação desse Java foi bem-sucedida. O AWS CDK CLI deve gerar o número da versão:
$cdk --version
Configurar a AWS CDKCLI
Depois de instalar o CDK CLI, você pode começar a usá-lo para desenvolver aplicativos em sua máquina local. Para interagir com o 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 instruções, consulte Autenticação e credenciais de acesso no Guia do usuário AWS Command Line Interface.
O CDK CLI usará automaticamente as credenciais de segurança que você configura com o AWS CLI. Por exemplo, se você for usuário da Central de Identidade IAM, poderá usar o comando aws configure sso para configurar credenciais de segurança. Se você for um usuário do IAM, poderá usar o comando aws configure. O AWS CLI guiará você 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 CDK CLI, como implantar um aplicativo com cdk deploy, o CDK CLI usará suas credenciais de segurança configuradas.
Assim como o AWS CLI, o CDK CLI usará seu perfil default por padrão. Você pode especificar um perfil usando a opção --profile da CDK CLI. Para obter mais informações sobre o uso de credenciais de segurança com o CDK CLI, consulte Configurar as credenciais de segurança para o AWS CDK CLI.
(Opcional) Instalar ferramentas AWS CDK adicionais
O AWS Toolkit for Visual Studio Code
Crie seu primeiro aplicativo CDK
Agora você está pronto para começar a usar o AWS CDK criando seu primeiro aplicativo CDK. Para instruções, consulte Tutorial: criar seu primeiro aplicativo AWS CDK.
