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á.

# Ambientes para o CDK da AWS
<a name="environments"></a>

Um ambiente consiste na conta da AWS e na região da AWS em que você implanta uma pilha do kit de desenvolvimento em nuvem da AWS (CDK da AWS).

 ** AWS Conta da**   
Ao criar uma conta da AWS, você recebe um ID da conta. Este ID é um número de 12 dígitos, como **012345678901**, que identifica de forma exclusiva sua conta. Para saber mais, consulte [Visualização de identificadores de conta da AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html) no *Guia de referência de gerenciamento de contas da AWS*.

 ** AWS Região da**   
 As regiões da AWS são nomeadas usando uma combinação de localização geográfica e um número que representa uma zona de disponibilidade na região. Por exemplo, ** us-east-1 ** representa uma zona de disponibilidade na região Leste dos EUA (Norte da Virgínia). Para saber mais sobre as regiões da AWS, consulte [Regiões e zonas de disponibilidade](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/). Para obter uma lista de códigos de região, consulte [Endpoints regionais](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) no *Guia de referência geral da AWS*.

O AWS CDK pode determinar ambientes a partir de suas credenciais e arquivos de configuração. Esses arquivos podem ser criados e gerenciados com a interface de linhad e comandos da AWS (AWS CLI). O seguinte é um exemplo básico de um desses arquivos:

 **Arquivo de credenciais**   

```
[default]
aws_access_key_id=ASIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token = IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE

[user1]
aws_access_key_id=ASIAI44QH8DHBEXAMPLE
aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY
aws_session_token = fcZib3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```

 **Arquivo de configuração**   

```
[default]
region=us-west-2
output=json

[profile user1]
region=us-east-1
output=text
```

É possível passar informações de ambiente desses arquivos em seu código CDK por meio de variáveis de ambiente fornecidas pelo CDK. Ao executar um comando da CLI do CDK, como `cdk deploy`, você fornece o perfil de suas credenciais e arquivos de configuração para coletar informações do ambiente.

Veja a seguir um exemplo de especificação dessas variáveis de ambiente no seu código CDK:

```
new MyDevStack(app, 'dev', {
  env: {
    account: process.env.CDK_DEFAULT_ACCOUNT,
    region: process.env.CDK_DEFAULT_REGION
}});
```

Veja a seguir um exemplo de passagem de valores associados ao perfil `user1` de suas credenciais e arquivos de configuração para a CLI do CDK usando a opção `--profile`. Os valores desses arquivos serão passados para suas variáveis de ambiente:

```
$ cdk deploy <myStack> --profile <user1>
```

Em vez de usar valores das credenciais e dos arquivos de configuração, você também pode codificar os valores do ambiente em seu código CDK. Veja um exemplo a seguir:

```
const envEU = { account: '238383838383', region: 'eu-west-1' };
const envUSA = { account: '837873873873', region: 'us-west-2' };

new MyFirstStack(app, 'first-stack-us', { env: envUSA });
new MyFirstStack(app, 'first-stack-eu', { env: envEU });
```

## Saiba mais
<a name="environments-learn"></a>

Para começar a usar ambientes com o AWS CDK, consulte [Configuração de ambientes para uso com o AWS CDK](configure-env.md).