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

444次阅读  |  发布于3年以前

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

关于 ServerLess Functions

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

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

图片来源:stackify

ServeLess 进一步了解

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

云厂商的支持

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

AWS Lambda function

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

以下几步需要你先完成:

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技术栈” 获取最新消息。

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

'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: 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
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技术栈” 获取最新信息。

Reference

Copyright© 2013-2020

All Rights Reserved 京ICP备2023019179号-8