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
- 第 8 行:函数名
注:中国区的项目一定要注明区域
.serverless 文件夹
当你运行 serverless deploy
部署命令之后,项目会生成一个 .serverless
文件夹,它将会部署到 Serverless 中去:
├── .serverless
│ ├── cloudformation-template-create-stack.json
│ ├── cloudformation-template-update-stack.json
│ ├── hello-world.zip
│ └── serverless-state.json
这部分内容,暂时不做详细的解释,暂时我们用不到。
最后,其实这个模版项目也只能做一个简单的 HellWorld
,在复杂的工程项目中,我们需要更多功能强大的 Serverless 模块才能完成,通过那些模块,让整个项目的代码更加有层次、开发体验更加的好,我们会在后面的实战运用中讲到。
〖坚持的一俢〗
网友评论