这是 AWS CDK v2 开发者指南。旧版 CDK v1 于 2022 年 6 月 1 日进入维护阶段，并于 2023 年 6 月 1 日终止支持。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# AWS CDK 入门
通过安装和配置 CDK 命令行接口 (AWS CDK CLI) 开始使用 AWS 云开发套件 ( AWS CD AWS K)。然后，使用 CDK CLI 创建您的第一个 CDK 应用程序，引导您的 AWS 环境并部署您的应用程序。
## 先决条件
在开始使用 AWS CDK 之前，请完成所有先决条件。对于那些不熟悉编程 AWS 或不熟悉编程的人来说，这些先决条件是必需的。有关说明，请参阅 [AWS CDK 先决条件](prerequisites.md)。
我们建议您对 AWS CDK 有基本的了解。有关更多信息，请参阅[什么是 AWS CDK](home.md)？ 并[学习 AWS CDK 的核心概念](core-concepts.md)。
## 安装 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 命令行界面用户指南*》中的[身份验证和访问凭证](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-authentication.html)。
CDK CLI 将自动使用您在 C AWS LI 中配置的安全证书。例如，如果您是 IAM Identity Center 用户，则可以使用 `aws configure sso` 命令配置安全凭证。如果您是 IAM 用户，则可以使用 `aws configure` 命令。 AWS CLI 将指导您在本地计算机上配置安全证书，并将必要信息保存在您的`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 中使用安全证书的更多信息，请参阅[为 CDK C AWS LI 配置安全证书](configure-access.md)。
## （可选）安装其他 AWS CDK 工具
[AWS Toolkit for Visual Studio Code](https://aws.amazon.com/visualstudiocode/) 是适用于 Visual Studio Code 的开源插件，有助于您在 AWS上创建、调试和部署应用程序。该工具包为开发 AWS CDK 应用程序提供了集成体验。它包括 AWS CDK Explorer 功能，用于列出您的 AWS CDK 项目并浏览 CDK 应用程序的各个组件。有关说明，请参阅：
+ [安装适用于 Visual Studio 代码的 AWS 工具包](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-toolkit.html)。
+ [AWS VS Code 的 CDK](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/cdk-explorer.html)。
## 创建第一个 CDK 应用程序
现在，您可以通过创建自己的第一个 AWS CDK 应用程序开始使用 CDK 了。有关说明，请参阅[教程：创建您的第一个 AWS CDK 应用程序](hello-world.md)。