Ambientes para o AWS CDK - AWS Cloud Development Kit (AWS CDK) v2
Saiba mais

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

Ambientes para o AWS CDK

Um ambiente consiste no Conta da AWS e no Região da AWS nos quais você implanta uma pilha AWS Cloud Development Kit (AWS CDK).

Conta da AWS

Ao criar um 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 Visualizar identificadores Conta da AWS no Guia de referência AWS Account Management.

Região da AWS

Regiões da AWS são nomeados 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 o Regiões da AWS, consulte Regiões e zonas de disponibilidade. Para 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 o AWS Command Line Interface (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

Você pode 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 CDK CLI, 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 transmissão de valores associados ao perfil user1 de suas credenciais e arquivos de configuração para o CDK CLI 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 Configurar ambientes para usar com o AWS CDK.