【Serverless 极速指南】解读项目

Serverless 模版创建出来的项目的文件内容特别的少，只有几个，但是麻雀虽小五脏俱全，我们还是认真的 Review 一遍：

这篇文章你会学习到：

• .gitignore
• handler.js
• serverless.yml
• .serverless

.gitignore

.gitignore 这个文件大家非常熟悉，它是 GIT 的忽略文件，想必 Serverless 也是将软件开源的思想，还是一行一行解读：

# package directories
node_modules
jspm_packages

# Serverless directories
.serverless

• 第 1 行：注释 以下是要忽略的程序包目录文件夹；
• 第 2 行：NPM 程序包目录，主要是 Nodejs 的包管理目录；
• 第 3 行：JSPM 程序包目录，Jspm 是浏览器端 JavaScript 的包管理工具；
• 第 4 行：注释 以下是要忽略的 Serverless 相关目录文件夹；
• 第 5 行：serverless 部署命令等生成的文件；

handler.js

handler.js 是有 Serverless 生成的一段程序模版，它会直接接入 Serverless ，并且输出 { message: 'Go Serverless v1.0! Your function executed successfully!', event }：

'use strict';

module.exports.hello = async event => {
    return {
        statusCode: 200,
        body: JSON.stringify(
            {
                message: 'Go Serverless v1.0! Your function executed successfully!',
                input: event,
            },
            null,
            2
        ),
    };

    // Use this code if you don't use the http event with the LAMBDA-PROXY integration
    // return { message: 'Go Serverless v1.0! Your function executed successfully!', event };
};

继续解读代码：

• 第 1 行：声明代码使用严格的 JavaScript 模式，在严格模式下将会有很多怪异的语法不能使用，你必须养成良好的编码习惯才行；
• 第 2 行：声明并导出 hello 函数模块，它的入参是 event 并且它是一个同步函数；
• 第 3 行：函数将返回一个对象；
• 第 4 行：返回对象的 HTTP 状态码 200，证明是成功的返回；
• 第 5 行：返回对象的数据体，返回数据体将以 JSON 数据字符串的形式返回（JSON.stringify 会将对象转成字符串）；
• 第 6 行：返回数据体对象的属性 message，它主要是前端或者请求者想要的到的数据，内容 'Go Serverless v1.0! Your function executed successfully!'；
• 第 7 行：返回数据体对象的属性 input，它是请求者传入的参数，值 event（传入参数值）；
• 第 8 行：null 是 JSON.stringify 方法的第二个参数，它是一个过滤函数，可以过滤掉一些不必要的属性，现在是不起作用的；
• 第 9 行：2 是 JSON.stringify 方法的第三个参数，他是用来格式化返回的 JSON 字符串的，2 代表缩进两个空格；
• 后面都是注释

OK，其实这段代码是将业务逻辑和 Serverless 结合的地方，Serverless 会调用这个 hello 方法，而 hello 方法内部就是我们要实现的业务逻辑。

serverless.yml

serverless.yml 是整个 Serverless 项目的描述文件或者配置文件：

service: hello-world
provider:
  name: aws
  runtime: nodejs10.x  
  stage: dev
  region: cn-north-1
functions:
  hello:
    handler: handler.hello

YAML 是专门编写配置文件的语言，了解它的语法可以自行百度。

这部分的配置非常多，我们只讲一部分：

• 第 1 行：设置服务名称为 hello-world；
• 第 2 行：Serverless 的服务提者：
  • 第 3 行：AWS 的服务。Serverless 有很多提供商：阿里云、Google、微软、IBM 等等；
  • 第 4 行：服务的运行时，这里是 nodejs 10.x 版本。同样运行时也有很多：java、python 等等；
  • 第 5 行：服务部署阶段，这里是 dev 开发阶段；
  • 第 6 行：AWS 服务所在区域，这里是中国北部区域；
• 第 7 行：向外提供的函数：
  • 第 8 行：函数名 hello
  • 第 8 行：Serverless 函数处理器 handler.hello

注：中国区的项目一定要注明区域

.serverless 文件夹

当你运行 serverless deploy 部署命令之后，项目会生成一个 .serverless 文件夹，它将会部署到 Serverless 中去：

├── .serverless
│   ├── cloudformation-template-create-stack.json
│   ├── cloudformation-template-update-stack.json
│   ├── hello-world.zip
│   └── serverless-state.json

这部分内容，暂时不做详细的解释，暂时我们用不到。

最后，其实这个模版项目也只能做一个简单的 HellWorld，在复杂的工程项目中，我们需要更多功能强大的 Serverless 模块才能完成，通过那些模块，让整个项目的代码更加有层次、开发体验更加的好，我们会在后面的实战运用中讲到。

〖坚持的一俢〗