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

Este é o Guia do Desenvolvedor 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 do

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

Conta da AWS

Ao criar um Conta da AWS, você recebe um ID da conta. Esse ID é um número de 12 dígitos, como 012345678901, que identifica sua conta de forma exclusiva. Para saber mais, consulte Exibir Conta da AWS identificadores no Guia de AWS Account Management referência.

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-1representa uma zona de disponibilidade na região Leste dos EUA (Norte da Virgínia). Para saber mais 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 AWS geral.

Eles AWS CDK podem 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). Veja a seguir um exemplo básico 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 CLI comando CDK, comocdk 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 como especificar essas variáveis de ambiente em 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 user1 perfil de suas credenciais e arquivos de configuração para o CDK CLI usando a --profile opção. 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, consulteConfigure ambientes para usar com o AWS CDK.