使用 AWS CDK in JavaScript

alias cdk="npx aws-cdk"

doskey cdk=npx aws-cdk $*

管理 AWS 构造库模块

使用 Node Package Manager ( npm ) 安装和更新 C AWS onstruct Library 模块以供您的应用程序使用，以及您需要的其他软件包。（ npm 如果你愿意，你可以 yarn 改用。） npm 还会自动安装这些模块的依赖关系。

大多数 AWS CDK 构造都位于名为 CDK 的主包中 aws-cdk-lib ，这是由创建的新项目中的默认依赖项。 cdk init “实验性” AWS 构造库模块（其中更高级别的构造仍在开发中）被命名为。 aws-cdk-lib/ SERVICE-NAME -alpha 服务名称带有 a ws- 前缀。如果您不确定某个模块的名称，请 在 NPM 上进行搜索 。

例如，以下命令安装的实验模块 AWS CodeStar。

npm install @aws-cdk/aws-codestar-alpha

某些服务的构造库支持位于多个命名空间中。例如，此外 aws-route53 ，还有另外三个 Amazon Route 53 命名空间， aws-route53-targets aws-route53-patterns 、和。 aws-route53resolver

您的项目的依赖关系在中维护 package.json 。您可以编辑此文件以将部分或全部依赖项锁定到特定版本，或者允许在特定条件下将其更新到较新的版本。要根据您在以下中指定的规则，将项目的 NPM 依赖项更新到允许的最新版本： package.json

npm update

在中 JavaScript，您可以将模块导入到代码中，其名称与使用 NPM 安装模块时使用的名称相同。在应用程序中导入 AWS CDK 类和 AWS 构造库模块时，我们建议采用以下做法。遵循这些准则将有助于使您的代码与其他 AWS CDK 应用程序保持一致并更易于理解。

使用 require() ，而不是 ES6 风格的指令 import 。Node.js 的旧版本不支持 ES6 导入，因此使用较旧的语法更具兼容性。（如果你真的想使用 ES6 导入，请使用 esm 来确保你的项目与所有支持的 Node.js 版本兼容。）

通常，从中导入单个类 aws-cdk-lib 。

const { App, Stack } = require('aws-cdk-lib');

如果您需要来自的许多类 aws-cdk-lib ，则可以使用命名空间别名来 cdk 代替导入各个类。避免两者兼而有之。

const cdk = require('aws-cdk-lib');

通常，使用短命名空间别名导入 AWS 构造库。

const { s3 } = require('aws-cdk-lib/aws-s3');

在中管理依赖关系 JavaScript

在 JavaScript CDK 项目中，依赖关系是在项目主目录 package.json 的文件中指定的。核心 AWS CDK 模块位于名为的单个NPM包中 aws-cdk-lib 。

当你使用安装软件包时 npm install ，NPM 会 package.json 为你记录该软件包。

如果你愿意，你可以用 Yarn 代替 NPM。但是，CDK 不支持 Yarn plug-and-play 模式，这是 Yarn 2 中的默认模式。将以下内容添加到您的项目 .yarnrc.yml 文件中以关闭此功能。

    
nodeLinker: node-modules

CDK 应用程序

以下是该 cdk init --language typescript 命令生成的示例 package.json 文件。为生成的文件 JavaScript 类似，只是没有 TypeScript相关的条目。

对于可部署的 CDK 应用程序， aws-cdk-lib 必须在的 dependencies 部分中指定。 package.json 你可以使用尖号 (^) 版本号说明符来表示你将接受比指定版本更高的版本，前提是它们位于同一个主版本内。

对于实验构造，请为 alpha 构造库模块指定确切版本，这些模块的 API 可能会发生变化。请勿使用 ^ 或 ~，因为这些模块的更高版本可能会带来的 API 更改，从而导致您的应用程序中断。

在的 devDependencies 部分中指定测试您的应用程序所需的库和工具版本（例如 jest 测试框架） package.json 。（可选）使用 ^ 来指定可以接受更高版本的兼容版本。

第三方构造库

如果您正在开发构造库，请使用 peerDependencies 和 devDependencies 部分的组合来指定其依赖关系，如以下示例 package.json 文件所示。

在中 peerDependencies ，使用尖号 (^) 指定您的库 aws-cdk-lib 所使用的最低版本。这样可以最大限度地提高您的库与一系列 CDK 版本的兼容性。为 alpha 构造库模块指定确切版本，这些模块的 API 可能会发生变化。使用 peerDependencies 可以确保 node_modules 树中只有一个所有 CDK 库的副本。

在中 devDependencies ，指定测试所需的工具和库，也可以使用 ^ 表示可以接受更高版本的兼容版本。准确指定（不带 ^ 或 ~）你宣传的库 aws-cdk-lib 与之兼容的其他 CDK 软件包的最低版本和其他 CDK 软件包。这种做法可确保您的测试针对这些版本运行。这样，如果您无意中使用了仅在新版本中找到的功能，则您的测试可以捕捉到它。

# Install the latest version of everything that matches the ranges in 'package.json'
npm install
# Install the same exact dependency versions as recorded in 'package-lock.json'
npm ci

# Install the latest version of everything that matches the ranges in 'package.json'
yarn upgrade
# Install the same exact dependency versions as recorded in 'yarn.lock'
yarn install --frozen-lockfile

要更新已安装的模块，可以使用前面的 npm install 和 yarn upgrade 命令。任一命令都会将软件包更新 node_modules 到满足中规则的最新版本 package.json 。但是，它们不会 package.json 自行更新，您可能需要这样做来设置新的最低版本。如果您托管软件包 GitHub，则可以将 De pendabot 版本更新配置为自动更新 。 package.json 或者，请使用 npm-check-updates 。

所有 C AWS onstruct Library 类都使用三个参数进行实例化：定义构造的 作用域 （构造树中的父级）、 id 和 props （构造函数用来配置其创建的资源的键/值对）。 AWS 其他类和方法也使用 “属性包” 模式作为参数。

使用具有良好 JavaScript 自动完成功能的 IDE 或编辑器将有助于避免拼写错误的属性名称。如果一个构造需要一个 encryptionKeys 属性，而你拼写了它 encryptionkeys ，那么在实例化构造时，你还没有传递你想要的值。如果该属性是必需的，则这可能会在合成时导致错误，或者如果该属性是可选的，则会导致该属性被静默忽略。在后一种情况下，你可能会得到一个你打算覆盖的默认行为。这里要特别小心。

对 AWS 构造库类进行子类化（或重写采用类似 props 的参数的方法）时，您可能需要接受其他属性供自己使用。这些值将被父类或重写方法忽略，因为在该代码中永远不会访问它们，因此您通常可以传递收到的所有道具。

future 版本 AWS CDK 可能会巧合地添加一个新属性，其名称是你用于自己的财产。然后，将您收到的值传递到继承链上可能会导致意外行为。如果你的属性被移除或设置为，那么传递一份你收到的道具的浅层副本会更安全。 undefined 例如：

super(scope, name, {...props, encryptionKeys: undefined});

或者，请命名您的属性，使其清楚地表明它们属于您的构造。这样，它们就不太可能在 future AWS CDK 版本中与属性发生冲突。如果其中有很多，请使用一个命名恰当的对象来存放它们。

对象（例如 props ）中缺失的值具有 undefined 中的值 JavaScript。通常的技术适用于处理这些问题。例如，访问可能未定义的值的属性的常用惯用法如下：

// a may be undefined, but if it is not, it may have an attribute b
// c is undefined if a is undefined, OR if a doesn't have an attribute b
let c = a && a.b;

但是， a 如果除此之外还有其他的 “假” 值 undefined ，则最好使测试更加明确。在这里，我们将利用这样一个事实，即 null 和 undefined 等于同时测试两者：

let c = a == null ? a : a.b;

合成和部署

可以使用以下命令合成 AWS CDK 应用程序中定义的 堆栈 并单独或一起部署。通常，当你发布它们时，你应该在项目的主目录中。

cdk synth ：从应用程序中的一个或多个堆栈中 AWS CDK 合成一个 AWS CloudFormation 模板。

cdk deploy ：将您的 AWS CDK 应用程序中的一个或多个堆栈定义的资源部署到。 AWS

您可以在单个命令中指定要合成或部署的多个堆栈的名称。如果您的应用程序只定义了一个堆栈，则无需指定该堆栈。

cdk synth                 # app defines single stack
cdk deploy Happy Grumpy   # app defines two or more stacks; two are deployed

您也可以使用通配符 *（任意数量的字符）和? （任何单个字符），用于按模式识别堆栈。使用通配符时，请用引号将模式括起来。否则，在将文件传递到 T AWS CDK oolkit 之前，shell 可能会尝试将其扩展为当前目录中的文件名。

cdk synth "Stack?"    # Stack1, StackA, etc.
cdk deploy "*Stack"   # PipeStack, LambdaStack, etc.

有关该 cdk 命令的完整文档，请参阅 AWS CDK 工具包（cdk命令） 。

使用 TypeScript 示例 JavaScript

TypeScript 是我们用来开发的语言 AWS CDK，也是开发应用程序时支持的第一种语言，因此编写了许多可用的 AWS CDK 代码示例 TypeScript。对于 JavaScript 开发人员来说，这些代码示例可能是一个很好的资源；你只需要删除代码中 TypeScript特定部分即可。

TypeScript 片段通常使用较新的ECMAScript import 和 export 关键字从其他模块导入对象，并声明要在当前模块之外提供的对象。Node.js 刚刚开始在其最新版本中支持这些关键词。根据您正在使用（或希望支持）的 Node.js 版本，您可以重写导入和导出以使用较旧的语法。

可以将导入替换为对 require() 函数的调用。

import * as cdk from 'aws-cdk-lib';
import { Bucket, BucketPolicy } from 'aws-cdk-lib/aws-s3';

const cdk = require('aws-cdk-lib');
const { Bucket, BucketPolicy } = require('aws-cdk-lib/aws-s3');

可以将导出分配给 module.exports 对象。

export class Stack1 extends cdk.Stack {
  // ...
export class Stack2 extends cdk.Stack {
  // ...
      
JavaScript

          
class Stack1 extends cdk.Stack {
  // ...
class Stack2 extends cdk.Stack {
  // ...
module.exports = { Stack1, Stack2 }
    
注意
使用旧式导入和导出的另一种方法是使用该esm模块。
    
对导入和导出进行排序后，就可以深入研究实际的代码了。您可能会遇到以下常用功能 TypeScript ：
    
可以为变量、类成员、函数参数和函数返回类型提供类型注释。对于变量、参数和成员，类型是在标识符后面加上冒号和类型来指定的。函数返回值遵循函数签名，由冒号和类型组成。
    
要将带类型注释的代码转换为 JavaScript，请删除冒号和类型。类成员中必须有一些值 JavaScript；undefined如果类成员中只有类型注释，则将其设置为 TypeScript。
      
TypeScript

          
var encrypted: boolean = true;
class myStack extends cdk.Stack {
    bucket: s3.Bucket;
    // ...
function makeEnv(account: string, region: string) : object {
    // ...
      
JavaScript

          
var encrypted = true;
class myStack extends cdk.Stack {
    bucket = undefined;
    // ...
function makeEnv(account, region) {
    // ...
    
在中 TypeScript，接口用于为必需属性和可选属性的捆绑包及其类型命名。然后，您可以使用接口名称作为类型注释。  TypeScript 将确保你用作函数参数的对象具有正确类型的必需属性。
    
interface myFuncProps {
    code: lambda.Code,
    handler?: string
    
JavaScript 没有接口功能，因此删除类型注释后，请完全删除接口声明。
    
当函数或方法返回通用类型（例如object），但您想将该值视为更具体的子类型以访问不属于更一般类型接口的属性或方法时， TypeScript 允许您使用as后跟类型或接口名称来转换值。  JavaScript 不支持（或不需要）这个，所以只需删除as和以下标识符即可。一种不太常见的强制转换语法是在方括号中使用类型名称<LikeThis>；这些强制转换也必须删除。
    
最后， TypeScript 支持类成员的访问修饰符publicprotected、和private。中的所有班级成员 JavaScript 都是公开的。只要在任何地方看到这些修饰符即可。
    
知道如何识别和删除这些 TypeScript 功能对于使简短的 TypeScript片段适应大有帮助.  JavaScript 但是，以这种方式转换较长的 TypeScript 示例可能不切实际，因为它们更有可能使用其他 TypeScript 功能。对于这些情况，我们建议使用 Sucras e。例如，如果代码使用未定义的变量，Sucrase 就不会抱怨。tsc如果它在语法上是有效的，那么除了少数例外，Sucrase 可以将其翻译为。 JavaScript这使得它对于转换可能无法单独运行的片段特别有价值。
    
迁移到  TypeScript
    
TypeScript随着项目规模越来越大、越来越复杂，许多 JavaScript 开发人员开始使用。  TypeScript 是 JavaScript（所有 JavaScript 代码均为有效代码，因此无需对 TypeScript 代码进行任何更改）的超集，而且它也是一种支持的语言。 AWS CDK 类型注释和其他 TypeScript 功能是可选的，当你发现其中的价值时，可以将其添加到你的 AWS CDK 应用程序中。 TypeScript 还可以让您在新 JavaScript 功能最终确定之前抢先体验这些新功能，例如可选的链接和空值合并，而且无需升级 Node.js。
    
TypeScript的 “基于形状” 的接口，它定义了对象中的必需和可选属性（及其类型）的捆绑包，允许您在编写代码时发现常见错误，并使您的 IDE 更容易提供强大的自动完成功能和其他实时编码建议。