環境 - AWS Cloud Development Kit (AWS CDK) V2

這是 AWS CDK v2 開發人員指南。較舊的 CDK 第 1 版已於 2022 年 6 月 1 日進入維護,並於 2023 年 6 月 1 日結束支援。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

環境

環境包含您將 AWS Cloud Development Kit (AWS CDK) 堆疊部署到的 AWS 帳戶 和 AWS 區域 。

AWS 帳戶

當您建立帳戶 ID 時 AWS 帳戶,您會收到一個帳戶 ID。這個識別碼是一組 12 位數的數字,例如 012345678901,可以唯一識別您的帳戶。若要深入瞭解,請參閱《AWS Account Management 參考指南》中的檢視 AWS 帳戶 識別碼

AWS 區域

AWS 區域 使用地理位置和代表區域中可用區域的數字的組合來命名。例如,us-east-1代表美國東部 (維吉尼亞北部) 區域中的可用區域。若要深入了解 AWS 區域,請參閱區域和可用區域。如需區域代碼的清單,請參閱《AWS 一般參考參考指南》中的「區域端點」。

AWS CDK 可以從您的認證和配置文件中確定環境。您可以使用 AWS Command Line Interface (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