1 分钟上手

注:欢迎加入 QQ 群(772109193)与大家一起交流学习。

通过本教程,你将学到:

  • 如何搭建本地开发环境?
  • FaasJS 项目的基本结构是什么?

准备工作

FaasJS 基于 Node.js 和 yarn 构建,因此需要本地环境支持至少 Node.js 8.x 和 yarn 1.x。

若使用的是 OS X,可以使用 brew 来安装:brew install node yarn

由于 FaasJS 基于 TypeScript,因此建议使用 Visual Studio Code 作为编辑器。

创建项目

你可以直接使用 npx 指令一键创建新项目,初次创建可以先跳过 Provider 配置:

npx create-faas-app

启动项目

执行 yarn faas server,用浏览器打开 http://localhost:3000/hello 即可看到 hello.func.ts 的执行结果。

文件结构

package.json

这是 Node.js 的项目配置,主要包含了依赖项、Babel 配置、esLint 配置和 jest 配置。

其中 FaasJS 只需依赖 faasjs 这个库,@faasjs/eslint-config-recommended 是用于代码规范检测的可选依赖库,便于团队之间使用统一的代码风格。

tsconfig.json

这个文件的内容仅仅为 {},因为 FaasJS 本身对 Typescript 没有特殊的配置需求,可以根据各自项目的实际情况进行定制化配置。

faas.yaml

这是 FaasJS 的配置文件,记录了云服务商的配置项和插件的配置项。

*.func.ts

这是云函数文件,在 FaasJS 中,所有云函数文件都必须以 .func.ts 结尾。

*.test.ts

这是单元测试文件,在 FaasJS 中,所有单元测试文件都必须以 .test.ts 结尾。

完整示例

https://github.com/faasjs/examples/tree/master/simple 可以看到一个包含了代码检查、自动化测试的简单例子。