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á.
# Começando com o AWS CDK
Comece a usar o AWS Cloud Development Kit (AWS CDK) instalando e configurando a AWS CDK Command Line Interface (CDK AWS CLI). Em seguida, use a CLI do CDK para criar seu primeiro aplicativo CDK, inicializar AWS seu 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 [Pré-requisitos do AWS CDK](prerequisites.md).
Recomendamos que você tenha uma compreensão básica do que é o AWS CDK. Para obter mais informações, consulte [O que é o AWS CDK](home.md)? e [aprenda os principais conceitos do AWS CDK](core-concepts.md).
## Instale a CLI do AWS CDK
Use o gerenciador de pacotes Node para instalar a CLI do CDK. Recomendamos que você o instale globalmente usando o seguinte comando:
```
$ npm install -g aws-cdk
```
Para instalar uma versão específica da CLI do CDK, use a estrutura de comando a seguir:
```
$ 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 da CLI do CDK 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 a CLI do CDK. Isso executará uma versão local, se ela existir. Caso contrário, a versão instalada globalmente será usada.
**Solução de problemas de instalação da CLI do CDK**
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 a CLI do CDK executando o seguinte:
```
$ npm uninstall -g aws-cdk
```
Em seguida, repita as etapas para reinstalar a CLI do CDK.
## Verifique se a instalação da CLI do CDK teve êxito
Execute os comandos a seguir para verificar se a instalação desse Java foi bem-sucedida. A CLI do AWS CDK deve gerar o número da versão:
```
$ cdk --version
```
## Configurar a CLI do AWS CDK
Depois de instalar a CLI do CDK, será possível começar a usá-la para desenvolver aplicações 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 a 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-authentication.html) no *Guia do usuário da interface de linha de AWS comando*.
A CLI do CDK usará automaticamente as credenciais de segurança que você configura com a CLI. AWS 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`. A AWS CLI 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 e. `config` `credentials` Então, ao usar a CLI do CDK, como ao implantar uma aplicação com `cdk deploy`, a CLI do CDK usará suas credenciais de segurança configuradas.
Assim como a AWS CLI, a CLI do CDK `default` usará seu perfil por padrão. É possível especificar um perfil usando a opção [`--profile`](ref-cli-cmd.md#ref-cli-cmd-options-profile) da CLI do CDK. Para obter mais informações sobre o uso de credenciais de segurança com a CLI do CDK, consulte [Configurar credenciais de segurança para](configure-access.md) a CLI do CDK. AWS
## (Opcional) Instale ferramentas AWS CDK adicionais
O [kit de ferramentas da AWS para Visual Studio Code](https://aws.amazon.com/visualstudiocode/) é um plugin de código aberto para o Visual Studio Code que ajuda você a criar, depurar e implantar aplicações na AWS. O kit de ferramentas fornece uma experiência integrada para o desenvolvimento de aplicativos AWS CDK. Ele inclui o recurso AWS CDK Explorer para listar seus projetos AWS CDK e navegar pelos vários componentes do aplicativo CDK. Para instruções, consulte:
+ [Instalando o AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-toolkit.html).
+ [AWS CDK para VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/cdk-explorer.html).
## Crie seu primeira aplicação 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 aplicativo AWS CDK](hello-world.md).