AWS CDK 的环境 - AWS Cloud Development Kit (AWS CDK) v2

这是 AWS CDK v2 开发者指南。旧版 CDK v1 于 2022 年 6 月 1 日进入维护阶段,并于 2023 年 6 月 1 日终止支持。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

AWS CDK 的环境

环境由您部署 AWS 云开发工具包 (AWS CDK) 堆栈的 AWS 账户和 AWS 区域组成。

AWS 账户

创建 AWS 账户时,您会收到一个账户 ID。此 ID 是一个 12 位数字(如 012345678901),用于唯一标识账户。要了解更多信息,请参阅《AWS 账户管理参考指南》中的查看 AWS 账户标识符

AWS 区域

AWS 区域是使用地理位置和代表区域内可用区的数字组合命名的。例如,us-east-1 表示美国东部(弗吉尼亚州北部)区域中的可用区。要了解有关 AWS 区域的更多信息,请参阅区域和可用区。有关区域代码的列表,请参阅《AWS 一般参考》参考指南中的区域端点

AWS CDK 可通过凭证和配置文件确定环境。可以使用 AWS 命令行界面 (AWS CLI) 创建和管理这些文件。以下是这些文件的基本示例:

凭证文件
[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
:配置文件
[default] region=us-west-2 output=json [profile user1] region=us-east-1 output=text

您可以通过 CDK 提供的环境变量在 CDK 代码中传递这些文件中的环境信息。在运行 CDK CLI 命令(例如 cdk deploy)时,您需要提供凭证和配置文件中的配置文件以从中收集环境信息。

以下是在 CDK 代码中指定这些环境的示例:

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

以下是使用 --profile 选项将与 user1 配置文件关联的值从凭证和配置文件传递给 CDK CLI 的示例。这些文件中的值将传递给环境变量:

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

您还可以在 CDK 代码中对环境值进行硬编码,而不必使用凭证和配置文件中的值。以下是示例:

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 });

了解更多

要开始在环境中使用 AWS CDK,请参阅配置可使用 AWS CDK 的环境