Serverless 实战 —— 函数计算 + Typescript 实践

前言

首先介绍下在本文出现的几个比较重要的概念：

函数计算（Function Compute）：函数计算是一个事件驱动的服务，通过函数计算，用户无需管理服务器等运行情况，只需编写代码并上传。函数计算准备计算资源，并以弹性伸缩的方式运行用户代码，而用户只需根据实际代码运行所消耗的资源进行付费。函数计算更多信息参考。
Aliyun Serverless VSCode Extension：是阿里云 Serverless 产品函数计算 Function Compute 的 VSCode 插件，该插件结合了函数计算 Funcraft：Funcraft 工具以及函数计算 SDK ，是一款 VSCode 图形化开发调试函数计算以及操作函数计算资源的工具。
Funcraft：Funcraft 是一个用于支持 Serverless 应用部署的工具，能帮助您便捷地管理函数计算、API 网关、日志服务等资源。它通过一个资源配置文件（template.yml），协助您进行开发、构建、部署操作。Fun 的更多文档参考。

目标

本文打算以一个简单的 Serverless 函数计算项目为例，尝试使用 typescript + nodejs 进行开发，搭建一个简单的工程项目，实现如下小目标：

使用 typescript 编写业务代码
可以通过 Serverless VSCode 插件本地调试 typescript 代码
通过插件将项目代码部署到云端

项目示例图

Serverless 实战 —— 函数计算 + Typescript 实践

实践

1. 前期准备 (可选)

在 VSCode 插件市场中搜索 Aliyun Serverless 插件并安装。

Serverless 实战 —— 函数计算 + Typescript 实践

根据 aliyun/fun 中的教程安装并配置 Docker。

前期准备的目的是为了方便开发和调试，目前阿里云 Function Compute 提供了命令行工具 Funcraft 以及图形化 VSCode 插件。安装 Docker 是为了在本地模拟线上环境进行调试，如果想快速浏览下 nodejs + typescript 工程项目的搭建，可以跳过。

2. 环境搭建

配置 tsconfig.json
- 执行 tsc --init，将会在项目根目录生成 tsconfig.json
- 配置 tsconfig.json 内容为：
  
  { "compilerOptions": { "target": "es5", "module": "commonjs", "noImplicitAny": true, "outDir": "./dist/", "sourceMap": true }, "include": [ "./src" ] }
配置 package.json
- 执行 npm init，将会在项目根目录生成 package.json
- 配置 package.json 内容为：
  
  { "name": "fc-ts", "version": "1.0.0", "description": "Function Compute + Typescript", "main": "index.js", "scripts": { "compile": "tsc -p ./" } }
编写业务代码
- 新建 src/index.ts 文件，编写内容如下：
  
  export const handler = ( event: any, context: any, callback: (err: any, data: any) => void, ) => { console.log(new String(event)); callback(null, 'hello world'); }
将 ts 代码编译为 js 代码
- 在 Terminal 中输入 npm run compile
- 完成后在项目根目录会有 dist 文件夹以及 dist/index.js、dist/index.js.map 文件

至此，我们搭建了一个常规的 typescript 项目，有 tsconfig.json、package.json、src 源码目录、dist 结果目录。其中，src/index.ts 文件中定义了一个 handler 方法，该方法符合函数计算中函数入口方法的定义。

3. 结合函数计算

在项目根目录新建 index.js 文件，文件内容如下：
```
const { handler } = require('./dist/index');

module.exports.handler = (event, context, callback) => {
  handler(event, context, callback);
}
```
这里又定义了一个 handler 方法，该方法中调用了编译后 js 文件中的 handler 方法。

在项目根目录新建 template.yml 文件，文件内容如下：

ROSTemplateFormatVersion: '2015-09-01'
Transform: 'Aliyun::Serverless-2018-04-03'
Resources:
  demo: # service name
    Type: 'Aliyun::Serverless::Service'
    Properties:
      Description: This is FC service
    func01: # function name
      Type: 'Aliyun::Serverless::Function'
      Properties:
        Handler: index.handler
        Runtime: nodejs8
        CodeUri: ./
        MemorySize: 1024
        Timeout: 15

该文件中对我们的资源（即函数计算中的服务以及函数）进行了定义，具体内容可以参考：Fun 规范文档。
如果安装了 Serverless VSCode 插件，那么可以尝试下插件的智能提示，效果如图：

Serverless 实战 —— 函数计算 + Typescript 实践

至此，我们就成功的将 typescript 项目结合到了函数计算中。我们的做法是：将 typescript 源码文件放置在 src 目录，将编译后的 js 文件放置在 dist 目录，最后在项目根目录中编写了 index.js 文件，文件中的 handler 处理函数调用了编译后 index 文件的入口函数。