Ambientes para o CDK da AWS - AWS Kit de desenvolvimento em nuvem (AWS CDK) v2
Saiba mais

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

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 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. Para obter uma lista de códigos de região, consulte Endpoints regionais 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

Para começar a usar ambientes com o AWS CDK, consulte Configuração de ambientes para uso com o AWS CDK.