AWS CDK 入門 - AWS 雲端開發套件 (AWS CDK) v2

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

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

AWS CDK 入門

安裝和設定 AWS CDK 命令列界面 (AWS CDK CLI),開始使用 AWS 雲端開發套件 (AWS CDK)。然後,使用 CDK CLI 建立您的第一個 CDK 應用程式、引導您的 AWS 環境,以及部署您的應用程式。

先決條件

開始使用 AWS CDK 之前,請先完成所有先決條件。這些先決條件是新加入 AWS 或新加入程式設計的先決條件。如需說明,請參閱 AWS CDK 先決條件

我們建議您對 AWS CDK 是什麼有基本的了解。如需詳細資訊,請參閱什麼是 AWS CDK?了解 AWS CDK 核心概念

安裝 AWS CDK CLI

使用Node套件管理員安裝 CDK CLI。建議您使用下列命令全域安裝:

$ npm install -g aws-cdk

若要安裝特定版本的 CDK CLI,請使用下列命令結構:

$ npm install -g aws-cdk@X.YY.Z

如果您想要使用多個版本的 AWS CDK,請考慮在個別 CDK 專案中安裝相符的 CDK CLI 版本。若要這樣做,請從npm install命令中移除 -g選項。然後,使用 npx aws-cdk 叫用 CDK CLI。如果本機版本存在,則會執行此版本。否則,將使用全域安裝的版本。

故障診斷 CDK CLI 安裝

如果您收到許可錯誤,且您的系統具有管理員存取權,請執行下列操作:

$ sudo npm install -g aws-cdk

如果您收到錯誤訊息,請嘗試執行下列動作來解除安裝 CDK CLI:

$ npm uninstall -g aws-cdk

然後,重複步驟來重新安裝 CDK CLI。

驗證成功的 CDK CLI 安裝

執行下列命令來驗證安裝是否成功。 AWS CDK CLI 應輸出版本編號:

$ cdk --version

設定 AWS CDK CLI

安裝 CDK CLI 後,您可以開始使用它在本機電腦上開發應用程式。若要與 互動 AWS,例如部署應用程式,您必須在本機電腦上設定安全登入資料,並具有執行您啟動之任何動作的許可。

若要在本機電腦上設定安全登入資料,請使用 AWS CLI。設定安全登入資料的方式取決於您管理使用者的方式。如需說明,請參閱《 AWS 命令列界面使用者指南》中的身分驗證和存取憑證

CDK CLI 會自動使用您使用 CLI AWS 設定的安全登入資料。例如,如果您是 IAM Identity Center 使用者,您可以使用 aws configure sso命令來設定安全登入資料。如果您是 IAM 使用者,您可以使用 aws configure命令。CLI AWS 將引導您在本機電腦上設定安全登入資料,並將必要資訊儲存在您的 configcredentials 檔案中。然後,當您使用 CDK CLI,例如透過 部署應用程式時cdk deploy,CDK CLI 將使用您設定的安全登入資料。

如同 AWS CLI,CDK CLI 預設會使用您的default設定檔。您可以使用 CDK CLI --profile選項指定設定檔。如需搭配 CDK CLI 使用安全登入資料的詳細資訊,請參閱設定 AWS CDK CLI 的安全登入資料

(選用) 安裝其他 AWS CDK 工具

AWS Toolkit for Visual Studio Code 是 的開放原始碼外掛程式Visual Studio Code,可協助您在其中建立、偵錯和部署應用程式 AWS。工具組提供開發 AWS CDK 應用程式的整合體驗。它包含 AWS CDK Explorer 功能,可列出您的 AWS CDK 專案並瀏覽 CDK 應用程式的各種元件。如需詳細說明,請參閱下列主題:

建立您的第一個 CDK 應用程式

您現在可以透過建立第一個 AWS CDK 應用程式開始使用 CDK。如需說明,請參閱教學課程:建立您的第一個 AWS CDK 應用程式