【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 行: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 模块才能完成,通过那些模块,让整个项目的代码更加有层次、开发体验更加的好,我们会在后面的实战运用中讲到。

〖坚持的一俢〗

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 226,097评论 6 523
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 97,198评论 3 410
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 173,602评论 0 370
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 61,750评论 1 304
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 70,684评论 6 404
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 54,151评论 1 317
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 42,349评论 3 433
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 41,430评论 0 282
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 47,986评论 1 328
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 39,969评论 3 351
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 42,071评论 1 359
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 37,667评论 5 352
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 43,358评论 3 342
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 33,757评论 0 25
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 34,944评论 1 278
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 50,684评论 3 384
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 47,123评论 2 368

推荐阅读更多精彩内容