美文网首页前端技术
【Serverless 极速指南】解读项目

【Serverless 极速指南】解读项目

作者: 一俢 | 来源:发表于2019-08-20 09:28 被阅读2次

    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 行:nullJSON.stringify 方法的第二个参数,它是一个过滤函数,可以过滤掉一些不必要的属性,现在是不起作用的;
    • 第 9 行:2JSON.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 模块才能完成,通过那些模块,让整个项目的代码更加有层次、开发体验更加的好,我们会在后面的实战运用中讲到。

    〖坚持的一俢〗

    相关文章

      网友评论

        本文标题:【Serverless 极速指南】解读项目

        本文链接:https://www.haomeiwen.com/subject/umtdsctx.html