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

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

# AWS CDK 入門
<a name="getting-started"></a>

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

## 先決條件
<a name="getting-started-prerequisites"></a>

開始使用 AWS CDK 之前，請先完成所有先決條件。這些先決條件是程式設計新手 AWS 或新手的必要條件。如需說明，請參閱 [AWS CDK 先決條件](prerequisites.md)。

我們建議您對 AWS CDK 是什麼有基本的了解。如需詳細資訊，請參閱[什麼是 AWS CDK？](home.md) 和[了解 AWS CDK 核心概念](core-concepts.md)。

## 安裝 AWS CDK CLI
<a name="getting-started-install"></a>

使用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。如果本機版本存在，則會執行此版本。否則，將使用全域安裝的版本。<a name="getting-started-install-troubleshoot"></a>

 **故障診斷 CDK CLI 安裝**   
如果您收到許可錯誤，且您的系統具有管理員存取權，請執行下列動作：  

```
$ sudo npm install -g aws-cdk
```
如果您收到錯誤訊息，請嘗試執行下列動作來解除安裝 CDK CLI：  

```
$ npm uninstall -g aws-cdk
```
然後，重複步驟來重新安裝 CDK CLI。

## 驗證成功的 CDK CLI 安裝
<a name="getting-started-install-verify"></a>

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

```
$ cdk --version
```

## 設定 AWS CDK CLI
<a name="getting-started-configure"></a>

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

若要在本機電腦上設定安全登入資料，請使用 AWS CLI。設定安全登入資料的方式取決於您管理使用者的方式。如需說明，請參閱《 * AWS 命令列界面使用者指南*》中的[身分驗證和存取憑證](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-authentication.html)。

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

如同 AWS CLI，CDK CLI 預設會使用您的`default`設定檔。您可以使用 CDK CLI [`--profile`](ref-cli-cmd.md#ref-cli-cmd-options-profile)選項指定設定檔。如需搭配 CDK CLI 使用安全登入資料的詳細資訊，請參閱[設定 AWS CDK CLI 的安全登入資料](configure-access.md)。

## （選用） 安裝其他 AWS CDK 工具
<a name="getting-started-tools"></a>

[AWS Toolkit for Visual Studio Code](https://aws.amazon.com/visualstudiocode/) 是 的開放原始碼外掛程式Visual Studio Code，可協助您在其中建立、偵錯和部署應用程式 AWS。工具組提供開發 AWS CDK 應用程式的整合體驗。它包含 AWS CDK Explorer 功能，可列出您的 AWS CDK 專案並瀏覽 CDK 應用程式的各種元件。如需詳細說明，請參閱下列主題：
+  [安裝 AWS Toolkit for Visual Studio 程式碼](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-toolkit.html)。
+  [AWS VS 程式碼的 CDK](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/cdk-explorer.html)。

## 建立您的第一個 CDK 應用程式
<a name="getting-started-app"></a>

您現在可以透過建立第一個 AWS CDK 應用程式開始使用 CDK。如需說明，請參閱[教學課程：建立您的第一個 AWS CDK 應用程式](hello-world.md)。