使用 Node.js 快速开启 ServerLess Functions：入门实践指南

五月君

发布于 2020-02-11 17:53:46

2.3K0

发布于 2020-02-11 17:53:46

近一年来我在很多地方看到 ServerLess 这一词出现，概念介绍的相对比较多，但是真正实践的还是很少，也是出于对新技术的好奇，所以我打算进一步的对 ServerLess 做一个了解，以便体验到 ServerLess 能给我们带来什么便捷，最好的例子还是先从一个 Hello World 开始。

关于 ServerLess Functions

Serverless 意为 “无服务器架构”，但是这并不意味着真的就无需服务器了，这些服务器的管理由云计算平台提供，对于用户侧无须关注服务器配置、监控、资源状态等，可以将重点放在业务逻辑上。

下图，将 Microservices 进一步细分为 Function as a Service（FaaS）函数即服务，相比微服务颗粒度更小。

图片来源：stackify

ServeLess 进一步了解

ServerLess 是什么？网上有很多关于这些的介绍，也许你可以参考，下面列举一些之前的分享：

云厂商的支持

截止目前已有很多云厂商支持 ServerLess：

Alibaba 函数计算
腾讯云函数 SCF
AWS Lambda Functions
Azure Functions
Google Cloud Functions
IBM Cloud Functions... 更多

AWS Lambda function

在本节示例中将使用 Aws Lambda，你可以选择上面列举的其它的服务商都是可以的，AWS 提供一年的免费试用，但是在使用 AWS 服务之前你需要先拥有一张有效的信用卡进行绑定，第一次 AWS 会扣除 1 美元的金额进行验证。

以下几步需要你先完成：

创建一个 AWS 账户，访问 console.aws.amazon.com/
设置你的 Provider Credentials，这里有一个详细的文档可参考：https://github.com/serverless/serverless/blob/HEAD/docs/providers/aws/guide/credentials.md，或者参考视频 https://www.youtube.com/watch?v=HSd9uYj2LJA

ServerLess 框架安装和配置

ServerLess 框架是一个使用 Node.js 编写的 CLI 工具，开发者无需关注底层资源即可部署完整可用的 Serverless 应用架构。在安装之前需要你先有 Node.js 运行环境，还没有安装 Node.js 的可以参考这篇文章 “3N 兄弟” 助您完成 Node.js 环境搭建 介绍了多种 Node.js 安装方式。

安装 serveless 框架

$ npm i serveless -g

检查 serverless 是否安装成功

$ serverless --version
Framework Core: 1.60.0
Plugin: 3.2.6
SDK: 2.2.1
Components Core: 1.1.2
Components CLI: 1.4.0

设置 AWS Credentials

如果已经设置了，可能会失败，在 serverless config credentials 后面加上 -o 即可。

$ serverless config credentials --provider aws --key <your_access_key_id> --secret <your_access_key_secret>
Serverless: Setting up AWS...

创建第一个 Nodejs ServerLess 项目

通过 serverless CLI 工具可以快速创建一个项目，--template 是该脚手架所支持的模板，更多模版可参考 github.com/serverless/serverless/tree/master/lib/plugins/create/templates

$ serverless create --template hello-world --path aws-hello-nodejs-function

Serverless: Generating boilerplate...
Serverless: Generating boilerplate in "/Users/test/aws-hello-nodejs-function"
 _______                             __
|   _   .-----.----.--.--.-----.----|  .-----.-----.-----.
|   |___|  -__|   _|  |  |  -__|   _|  |  -__|__ --|__ --|
|____   |_____|__|  \___/|_____|__| |__|_____|_____|_____|
|   |   |             The Serverless Application Framework
|       |                           serverless.com, v1.60.0
 -------'

Serverless: Successfully generated boilerplate for template: "hello-world"

创建成功后可以看到如下项目结构

├── handler.js # 逻辑处理
├── .gitignore # 忽略文件
└── serverless.yml # ServerLess 配置文件

handler.js

handler.js 是逻辑处理的地方，当然你也可以自定义其它的文件，一旦自定义文件之后需要在 serverless.yml 文件里也进行响应更改，本节只是入门所以不会太复杂，后续会出一个使用 ServerLess 实现的 REST API 实践，可以关注公众号 “Nodejs技术栈” 获取最新消息。

以下有三个参数是你需要了解的：

event：用来解析请求的数据
context：使用 context 将运行时参数传递给 Lambda 函数
callback 返回响应数据

'use strict';

module.exports.helloWorld = (event, context, callback) => {
  const response = {
    statusCode: 200,
    headers: {
      'Access-Control-Allow-Origin': '*', // Required for CORS support to work
    },
    body: JSON.stringify({
      message: 'Go Serverless v1.0! Your function executed successfully!',
      input: event,
    }),
  };

  callback(null, response);
};

serverless.yml

service：服务名称
provider：定义你的服务需要部署的位置
functions：定义要部署的代码
functions.helloWorld：函数
functions.helloWorld.handler：value 中的 “handle.helloWorld” 定义了函数文件的路径，handle 文件下的 helloWorld 函数
functions.helloWorld.events：events 定义了如何触发 “handler.helloWorld” 程序

service: aws-hello-nodejs-function

provider:
  name: aws
  runtime: nodejs12.x

functions:
  helloWorld:
    handler: handler.helloWorld
    events:
      - http:
          path: hello-world # 定义请求路径
          method: get # 定义接口请求方式
          cors: true # 开启跨域

部署

列举一些 ServerLess 部署相关的命令：

部署全部：$ serverless deploy
单个部署：$ serverless deploy function -f helloWorld
本地触发一个函数测试：$ serverless invoke local -f helloWorld
查看日志：$ serverless logs -f helloWorld -l

执行命令 serverless deploy 看到以下信息，一个服务就已经部署成功了，是不是感觉很简单呢？服务器环境搭建、部署这些无需在关注了，可以专注于业务开发。

$ serverless deploy
Serverless: Packaging service...
Serverless: Excluding development dependencies...
Serverless: Creating Stack...
Serverless: Checking Stack create progress...
........
Serverless: Stack create finished...
Serverless: Uploading CloudFormation file to S3...
Serverless: Uploading artifacts...
Serverless: Uploading service aws-hello-nodejs-function.zip file to S3 (404 B)...
Serverless: Validating template...
Serverless: Updating Stack...
Serverless: Checking Stack update progress...
.................................
Serverless: Stack update finished...
Service Information
service: aws-hello-nodejs-function
stage: dev
region: us-east-1
stack: aws-hello-nodejs-function-dev
resources: 12
api keys:
  None
endpoints:
  GET - https://**********.execute-api.us-east-1.amazonaws.com/dev/hello-world
functions:
  helloWorld: aws-hello-nodejs-function-dev-helloWorld
layers:
  None
Serverless: Run the "serverless" command to setup monitoring, troubleshooting and testing.

以上日志中的 endpoints 展示了访问的接口地址，现在你可以通过接口来调用，或者 postman、curl 访问。

$ curl https://******.execute-api.us-east-1.amazonaws.com/dev/hello-world

本地测试 ServerLess-Offline

使用这个 serverless-offline 插件可以在本地启动一个 HTTP 服务器模拟 AWS λ 和 API Gateway。

安装插件

安装插件，如果本地没有 package.json 文件，可以 npm init 生成一个 package.json 文件

$ npm install serverless-offline --save-dev

修改 serverless.yml

在项目的 serverless.yml 里添加插件 serverless-offline，如下所示：

plugins:
    - serverless-offline

本地启动

项目根目录执行 serverless offline 命令，就可成功的在本地开启测试

$ serverless offline
Serverless: Starting Offline: dev/us-east-1.

Serverless: Routes for helloWorld:
Serverless: GET /hello-world
Serverless: POST /{apiVersion}/functions/aws-hello-nodejs-function-dev-helloWorld/invocations

Serverless: Offline [HTTP] listening on http://localhost:3000

默认地址为 http://localhost:3000 如下所示就可轻松的访问我们上面的例子

$ curl http://localhost:3000/hello-world

serverless-offline 提供了很多选项是可以让你自定义的，例如修改启动项目监听的端口，可以参考 github.com/dherault/serverless-offline

本节 Github 源码地址如下：

https://q-angelo.github.io/project-training/serverless/movies/aws-hello-nodejs-function

总结

通过本节入门指南，希望你能掌握如何去开启一个 ServerLess 应用程序以及如何部署、在本地进行开发调试，这只是一个开始，下一节我将在这个基础之上使用 ServerLess、Node.js 和 MongoDB Atlas cloud 构建一个 REST API，敬请关注公众号 “Nodejs技术栈” 获取最新信息。