AWS CDK 的教程 AWS Cloud9

在 AWS Cloud9 IDE 的终端会话中，确保安装了最新的安全更新和错误修复。要执行此操作，请运行 yum update（适用于 Amazon Linux）或 apt update 命令（适用于 Ubuntu Server）。（要开始新的终端会话，请在菜单栏上依次选择 Window（窗口）> New Terminal（新建终端）。）

对于 Amazon Linux：

sudo yum -y update

对于 Ubuntu Server：

sudo apt update

确认是否已安装 nvm。为此，请运行带 --version 选项的 nvm 命令。

nvm --version

如果成功，则输出包含 nvm 版本号，并且您可以向前跳至 步骤 1.2：安装 Node.js。

下载并安装 nvm。要执行此操作，请运行安装脚本。在此示例中，安装了 v0.33.0，但您可以在此处检查 nvm 的最新版本。

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash

开始使用 nvm。您可用关闭终端会话并重新启动，或者查找包含命令以加载 nvm 的 ~/.bashrc 文件。

. ~/.bashrc

确认是否已安装 Node.js，如果已安装，请确认安装的版本为 16.17.0 或更高版本。此示例使用 Node.js 16.17.0 进行测试。要检查结果，请在终端会话仍在 IDE 中打开的情况下，运行带有 --version 选项的 node 命令。

node --version

如果已安装 Node.js，则输出将包含版本号。如果该版本号是 v16.17.0，请向前跳至 步骤 1.3：安装 TypeScript。

安装 Node.js 16，方法是运行带有 install 操作的 nvm 命令。

nvm install v16

开始使用 Node.js 16。为此，请运行 nvm 命令与 alias 操作、别名的版本号以及要用于该别名的版本，如下所示。

nvm alias default 16

要确认您使用的是 Node.js 16，请再次运行 node --version 命令。如果已安装正确的版本，则输出将包含版本 v16。

确认您是否已经 TypeScript 安装。为此，在终端会话仍在 IDE 中处于打开状态的情况下，使用--version选项运行命令行 TypeScript 编译器。

tsc --version

如果您已 TypeScript 安装，则输出将包含 TypeScript 版本号。如果 TypeScript 已安装，请直接跳至步骤 1.4：安装 AWS CDK。

安装 TypeScript。为此，请运行带有install操作、-g选项和 TypeScript 软件包名称的npm命令。它 TypeScript 作为全局软件包安装在环境中。

npm install -g typescript

确认 TypeScript 已安装。为此，请使用--version选项运行命令行 TypeScript 编译器。

tsc --version

如果 TypeScript 已安装，则输出将包含 TypeScript 版本号。

确认您是否已经 AWS CDK 安装了。为此，请在终端会话仍在 IDE 中打开的情况下，运行带有 --version 选项的 cdk 命令。

cdk --version

如果安装了， AWS CDK 则输出将包含 AWS CDK 版本号和内部版本号。向前跳至 步骤 2：添加代码。

AWS CDK 通过运行npm命令以及install操作、要安装的 AWS CDK 软件包的名称以及在环境中全局安装软件包的-g选项来安装。

npm install -g aws-cdk

确认已 AWS CDK 安装并正确引用。为此，请运行带 --version 选项的 cdk 命令。

cdk --version

如果成功，则会显示 AWS CDK 版本号和内部版本号。

在终端会话仍在 IDE 中打开的情况下，创建存储项目源代码的目录，例如您环境中的 ~/environment/hello-cdk 目录。然后切换到该目录。

rm -rf ~/environment/hello-cdk # Remove this directory if it already exists.
mkdir ~/environment/hello-cdk  # Create the directory.
cd ~/environment/hello-cdk     # Switch to the directory.

将该目录设置为的 TypeScript 语言项目 AWS CDK。为此，请运行带有 init 操作、 sample-app 模板和 --language 选项以及编程语言名称的 cdk 命令。

cdk init sample-app --language typescript

这将在该目录中创建以下文件和子目录。

在 Environment（环境）窗口中，打开 lib/hello-cdk-stack.ts 文件，并浏览该文件中的以下代码。

import sns = require('@aws-cdk/aws-sns');
import sqs = require('@aws-cdk/aws-sqs');
import cdk = require('@aws-cdk/cdk');

export class HelloCdkStack extends cdk.Stack {
  constructor(parent: cdk.App, name: string, props?: cdk.StackProps) {
    super(parent, name, props);

    const queue = new sqs.Queue(this, 'HelloCdkQueue', {
      visibilityTimeoutSec: 300
    });

    const topic = new sns.Topic(this, 'HelloCdkTopic');

    topic.subscribeQueue(queue);
  }
}

在 Environment（环境）窗口中，打开 bin/hello-cdk.ts 文件，并浏览该文件中的以下代码。

#!/usr/bin/env node
import cdk = require('@aws-cdk/cdk');
import { HelloCdkStack } from '../lib/hello-cdk-stack';

const app = new cdk.App();
new HelloCdkStack(app, 'HelloCdkStack');
app.run();

此代码从 HelloCdkStack 文件中加载、实例化然后运行 lib/hello-cdk-stack.ts 类。

用于npm运行编 TypeScript 译器以检查编码错误，然后启用 AWS CDK 以执行项目的bin/hello-cdk.js文件。为此，请从项目的根目录中运行带有 run 操作的 npm 命令，指定 package.json 文件中的 build 命令值，如下所示。

npm run build

前面的命令运行 TypeScript 编译器，该编译器添加了支持lib/hello-cdk-stack.d.ts文件bin/hello-cdk.d.ts和文件。该编译器还可将 hello-cdk.ts 和 hello-cdk-stack.ts 文件转换为 hello-cdk.js 和 hello-cdk-stack.js 文件。

AWS CDK 创建 AWS CloudFormation 堆栈模板。为此，在终端会话仍在 IDE 中打开的情况下，从项目的根目录，运行带有 synth 操作和堆栈名称的 cdk 命令。

cdk synth HelloCdkStack

如果成功，输出将显示 AWS CloudFormation 堆栈模板的Resources部分。

首次在特定 AWS 账户和 AWS 区域组合的环境中部署 AWS CDK 应用程序时，必须安装引导堆栈。该堆栈包含完成各种操作 AWS CDK 所需的各种资源。例如，此堆栈包含一个 Amazon S3 存储桶， AWS CDK 用于在其部署过程中存储模板和资产。要安装引导堆栈，请运行带有 bootstrap 操作的 cdk 命令。

cdk bootstrap

cdk bootstrap --profile test 123456789012/us-east-1

让 AWS CDK 运行 AWS CloudFormation 堆栈模板来部署堆栈。为此，从项目的根目录，运行带有 deploy 操作和堆栈名称的 cdk 命令。

cdk deploy HelloCdkStack

如果成功，则输出将显示 HelloCdkStack 堆栈已部署且没有错误。

要确认 Amazon SNS 主题和 Amazon SQS 队列已成功部署，请发送消息到该主题，然后检查队列是否收到消息。为此，您可以使用诸如 AWS Command Line Interface (AWS CLI) 或之类的工具 AWS CloudShell。有关这些工具的更多信息，请参阅 AWS CLI 还有 aws-shell 教程 AWS Cloud9。

例如，要在终端会话仍在 IDE 中处于打开状态的情况下 AWS CLI 向主题发送消息，请使用运行 Amazon SNS publish命令，提供消息的主题和正文、主题的 AWS 区域以及主题的 Amazon 资源名称 (ARN)。

aws sns publish --subject "Hello from the AWS CDK" --message "This is a message from the AWS CDK." --topic-arn arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K

在前面的命令中，arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K替换为 AWS CloudFormation 分配给该主题的 ARN。为获取该 ID，您可以运行 Amazon SNS list-topics 命令。

aws sns list-topics --output table --query 'Topics[*].TopicArn'

如果成功，则 publish 命令的输出将显示所发布消息的 MessageId 值。

要检查队列是否收到消息，请运行 Amazon SQS receive-message 命令，提供队列的 URL。

aws sqs receive-message --queue-url https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K

在前面的命令中，https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K替换为 AWS CloudFormation 分配给队列的 ARN。为获取该 URL，您可以运行 Amazon SQS list-queues 命令。

aws sqs list-queues --output table --query 'QueueUrls[*]'

如果成功，则 receive-message 命令的输出将显示收到的消息的相关信息。