這是 AWS CDK v2 開發人員指南。較舊的 CDK v1 已於 2022 年 6 月 1 日進入維護,並於 2023 年 6 月 1 日結束支援。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
的環境 AWS CDK
環境包含 AWS 區域 您部署 AWS Cloud Development Kit (AWS CDK) 堆疊的 AWS 帳戶 和 。
- AWS 帳戶
-
當您建立 時 AWS 帳戶,會收到帳戶 ID。此 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 }});
以下是CLI使用 --profile
選項,將與user1
設定檔相關聯的值從登入資料和組態檔案傳遞至 CDK 的範例。來自這些檔案的值將傳遞至您的環境變數:
$
cdk deploy
myStack
--profileuser1
您也可以在 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。