@3boysdad/serverless-plugin-typescript 中文文档教程

Question

serverless-plugin-typescript

无服务器插件零配置 Typescript 支持

3boysdad Update

原始 NPM 模块：http:

//www.npmjs.com/package/serverless-plugin-typescript此版本的 serverless-typescript-plugin 修复了 Windows 操作系统的符号链接问题，导致以下错误：

1) EPERM：不允许操作，符号链接…

当尝试创建符号链接到构建目录中的“package.json”文件时。

我不会为原始插件创建 PR，因为它现在似乎已经死了。 虽然我的解决方案有效，但我很确定这只是一个 hack。

Features

• Zero-config: Works out of the box without the need to install any other compiler or plugins
• Supports ES2015 syntax + features (export, import, async, await, Promise, …)
• Supports sls package, sls deploy and sls deploy function
• Supports sls invoke local + --watch mode
• Integrates nicely with serverless-offline

Install

yarn add --dev @3boysdad/serverless-plugin-typescript

或

npm install --save-dev @3boysdad/serverless-plugin-typescript

添加以下插件到你的serverless.yml：

plugins:
  - '@3boysdad/serverless-plugin-typescript'

Configure

见example 文件夹 一个最小的例子。

tsconfig.json

插件使用的默认 tsconfig.json 文件如下所示：

{
  "compilerOptions": {
    "preserveConstEnums": true,
    "strictNullChecks": true,
    "sourceMap": true,
    "target": "es5",
    "outDir": ".build",
    "moduleResolution": "node",
    "lib": ["es2015"],
    "rootDir": "./"
  }
}

注意 1：不能覆盖 outDir 和 rootDir 选项。 ** 考虑“修复”这个 ** 因为它看起来很老套。

注意 2：不要将此存储库中的 tsconfig.json 与上面提到的混淆。

Including extra files

个人而不是这个请使用并安装插件 - serverless-plugin-include-dependencies。

Usage

Google Cloud Functions

通过 serverless-google-cloudfunctions 使用 Google Cloud Functions 时 插件，您只需在 package.json 中提供一个 main 字段：

{
  // ...
  "main": "handler.js",
  // ..
}

此插件将自动正确编译您的打字稿。 笔记 该字段必须引用编译后的文件名，即以 .js 结尾 扩大。

如果未找到 main 字段，则此插件将使用 index.js。 前 编译开始，它将检查指示的文件是否存在 .ts 扩展名，然后再实际尝试编译它。

Automatic compilation

正常的 Serverless 部署过程将自动使用 Typescript 进行编译：

• Create the Serverless project with serverless create -t aws-nodejs
• Install Serverless Typescript as above
• Deploy with serverless deploy

Usage with serverless-offline

该插件与 serverless-offline 集成得很好 在本地模拟 AWS Lambda 和 AWS API Gateway。

将插件添加到您的 serverless.yml 文件并确保 @hewmen/serverless-plugin-typescript 在 serverless-offline 之前，因为顺序很重要：

  plugins:
    ...
    - '@hewmen/serverless-plugin-typescript'
    ...
    - serverless-offline
    ...

运行 serverless offline 或 serverless offline start 以启动 Lambda/API 模拟。

与 serverless offline 相比，start 命令将触发一个 init 和一个 end 生命周期钩子，这是需要的serverless-offline 和例如 serverless-dynamodb-local 关闭资源（见下文）

serverless-dynamodb-local

配置您的服务与上述相同，但另外添加 serverless- dynamodb-local 插件如下：

  plugins:
    - '@hewmen/serverless-plugin-typescript'
    - serverless-dynamodb-local
    - serverless-offline

运行serverless offline start。

Other useful options

您可以使用 --dontPrintOutput 和 使用 --noTimeout 禁用超时。

Run a function locally

要在本地运行已编译的函数，您可以：

$ serverless invoke local --function <function-name>

选项是：

• --function or -f (required) is the name of the function to run
• --watch - recompile and run a function locally on source changes
• --path or -p (optional) path to JSON or YAML file holding input data
• --data or -d (optional) input data

Enabling source-maps

您可以通过安装和使用以下插件轻松启用对源映射的支持（使堆栈跟踪更易于阅读）：

yarn add --dev source-map-support

// inside of your function
import 'source-map-support/register'

如果您正在使用 webpack（最有可能）。 添加 devtool: 'source-map' 到 webpack.config.js：

module.exports = {
  .... snip ....
  devtool: 'source-map',
  .... snip ....

}

Help & Community

加入我们的 Slack 社区 如果您遇到问题或有疑问。 我们喜欢和你聊天！