AWS CDK - 如何在本地运行 API 和 Lambda？

Question

编辑：原来解决方案在文档中。我安装了沼泽标准普通“sam”，但我需要他们所谓的“公共预览版”AKA“sam-beta-cdk”。安装后，API 可以在本地使用sam-betacdk start-api 启动并且运行良好。虽然我很欣赏建议应该使用纯 TDD 来完成开发的答案，但我觉得这种更具交互性的手动模式也很有价值，因为它允许更快地探索问题空间。

我正在尝试使用 API Gateway、Lambdas 和 DynamoDB 使用 CDK + Typescript 构建我的第一个应用程序。我已经构建了几个 Lambdas 并部署了它们，它们在网络上运行良好。但是，我不希望将一分钟的部署周期和各种相关的 AWS 成本作为我工作流程的一部分。我想要的是能够在本地测试我的 API。

我一直在努力寻找有关如何执行此操作的文档。亚马逊似乎建议使用 SAM CLI here，这就是我一直在尝试的。

文档声称运行 sam local xyz 运行 cdk synth 以在 ./aws-sam/build 中进行“可以组装”，但我没有看到这方面的证据。相反，我得到的是 sam 找不到“template.yml”的投诉。所以我手动运行cdk synth > template.yml，它会在根文件夹中创建一个。然后我运行sam local start-api，它似乎很高兴启动。

然后我尝试使用 CURL：curl 'http://127.0.0.1:3000/test' 命中我的测试 lambda，我得到 {"message":"Internal server error"} 和一个巨大的丑陋堆栈跟踪在运行 sam local start-api 的控制台中

lambda 是这个...

exports.handler = async function() {
    console.log("WooHoo! Test handler ran")
    return {statusCode: 200, headers: {"Content-Type": "application/json"}, body: "Test handler ran!"}
}

巨大的丑陋堆栈跟踪的开始......

Mounting /home/user/code/image-cache/asset.beeaa749e012b5921018077f0a5e4fc3ab271ef1c191bd12a82aa9a92148782e as /var/task:ro,delegated inside runtime container
START RequestId: 99f53642-b294-4ce5-a1b4-8c967db80ce1 Version: $LATEST
2021-09-15T12:33:37.086Z    undefined   ERROR   Uncaught Exception  {"errorType":"Runtime.ImportModuleError","errorMessage":"Error: Cannot find module 'test'\nRequire stack:\n- /var/runtime/UserFunction.js\n- /var/runtime/index.js","stack":["Runtime.ImportModuleError: Error: Cannot find module 'test'","Require stack:","- /var/runtime/UserFunction.js","- /var/runtime/index.js","    at _loadUserApp (/var/runtime/UserFunction.js:100:13)","    at Object.module.exports.load (/var/runtime/UserFunction.js:140:17)",

巨大丑陋的堆栈跟踪结束...

Invalid lambda response received: Lambda response must be valid json

所以看起来sam local start-api 找不到test 并抛出错误，这意味着API 网关没有得到有效的“lambda 响应”。到目前为止，这并没有帮助我解决问题：/ 它似乎确实意识到测试是一条路线，因为尝试命中其他端点给出了经典的{"message":"Missing Authentication Token"}，但尽管我同时拥有functions/test.ts，但试图实现它却很难实现它和编译后的functions/test.js 存在。

我在我的 CDK 堆栈定义中定义了测试路由和处理程序，如下所示...

    const testLambda = new lambda.Function(this, "testLambdaHandler", {
      runtime: lambda.Runtime.NODEJS_14_X,
      code: lambda.Code.fromAsset("functions"),
      handler: "test.handler"
    })

    api.root
      .resourceForPath("test")
      .addMethod("GET", new apigateway.LambdaIntegration(testLambda))

我考虑过发布我的 template.yml，但这比大而丑陋的错误消息还要长，所以我没有。

所以我有三个问题（实际上是一百万，但我不想太厚脸皮！）

1. 这实际上是本地测试使用 CDK 制作的应用程序的规范方式吗
2. 如果是这样，我哪里出错了？
3. 如果不是，更好/正确的方法是什么？

Answer 1

您的文件目录一定有问题。您的 index.js 在哪里？如果生成template.json，目录是否正确？ 还有在哪个目录下执行 Sam 本地命令？

测试无服务器应用程序的好处是您不必测试整个应用程序。您需要依靠 AWS，API 网关、dynamodb 和 lambda 可以完美运行。 您唯一需要测试的是您实现的逻辑。

在这里，您确保您的函数打印出一些内容并返回 200。这就是您所要做的。 研究 'jest' 来测试 js。

如果你想测试 cdk 你应该进入https://docs.aws.amazon.com/cdk/latest/guide/testing.html

“在本地运行 Aws”也不是好的做法。它与现实生活中的运行方式（即云）完全不同。您为此使用插件，为此使用工具...本地与云端不同。

如果您还有其他问题，请随时提问。

Answer 2

Lambda 处理程序只是函数。它们不需要任何特殊的环境来运行——它们在 Lambda 调用过程中的特定点被调用，并提供一个事件（一个 json 对象）和一个上下文（另一个 json 对象）

您可以（并且应该！）对它们进行单元测试，就像您的语言/测试框架中的任何其他单独功能一样。

正如@Lucasz 所提到的，您应该相信，如果设置正确，API 网关和 Lambda 每次都会以相同的方式交互。一旦您运行了端到端测试并且您知道基础工作正常，任何进一步的实现都可以通过单元测试完成

有许多用于在单元测试中模拟 AWS 服务调用的库，并且对于更难以模拟的服务有很多好的实践变通方法（即：很难从另一个 lambda 内部模拟 Lambda 调用 - 但是如果您将该 lambda 调用包装在其自己的函数中，您可以模拟该函数本身以返回您想要的任何内容 - 这也是测试的好习惯！）

使用 jest，在编码单元测试中，您可以调用 lambda 处理程序，为其提供存根或模拟事件 json，以及上下文 json（可能只是空白，因为您没有使用它），然后 lambda 处理程序将执行就像您编写的任何其他具有两个参数的函数一样，包括返回您希望它返回的内容。