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

這是 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 --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