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á.
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. 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 Gerenciamento de contas .
- 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 uma lista de códigos de região, consulte Endpoints regionais no Guia de referência geral da AWS .
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). 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. Quando você executa um CDK CLI comando, comocdk deploy
, em seguida, 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 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
--profileuser1
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.