(给前端大全加星标,提升前端技能)[h1]基于Seneca 和 PM2构建
[/h1]本章主要分为三个小节:
- 选择Nodejs的理由:将证明选择Node.js来构建的正确性。介绍使用Node.js时设计的软件栈。
- 微服务架构Seneca:关于Seneca 的基本知识。
- PM2:PM2 是运行 Node.js 应用的最好选择。
[h2]选着Node.js的理由[/h2]如今,Node.js 已经成为国际上许多科技公司的首选方案。特别对于在服务器端需要费阻塞特性的场景,Node.js 俨然成了最好的选择。
本章我们主要讲Seneca 和 PM2 作为构建、运行微服务的框架。虽然选择了Seneca和PM2,但并不意味着其他框架不好。
业界还存在一些其他被选方案,例如 restify或Express、Egg.js 可用于构建应用,forever或者nodemon可用于运行应用。而Seneca和PM2我觉得是构建微服务最佳的组合,主要原因如下:
- PM2 在应用部署方面有着异常的强大功能。
- Seneca 不仅仅是一个构建服务的架构,它还是个范例,能够重塑我们对于面向对象软件的认识。
[h2]第一个程序 --- Hello World[/h2]Node.js 中最兴奋的理念之一就是简单。只要熟悉 JavaScript,你就可以在几天内学会Node.js。用Node.js编写的代码要比使用其他语言编写的代码更加简短:
- const http = require('http');
复制代码
- const hostname = '127.0.0.1';
复制代码
- const server = http.createServer((req, res) => {
复制代码- res.setHeader('Content-Type', 'text/plain');
复制代码- res.end('Hello World\n');
复制代码
- server.listen(port, hostname, () => {
复制代码- console.log(`Server running at http://${hostname}:${port}/`);
复制代码 上述代码创建了一个服务端程序,并监听 3000 端口。运行代码后可在浏览器中输入:http://127.0.0.1:3000,既可预览到。
[h2]Node.js 的线程模型[/h2]Node.js 采用的是异步处理机制。这表示在处理较慢的事件时,比如读取文件,Node.js 不会阻塞线程,而是继续处理其他事件,Noede.js 的控制流在读取文件完毕时,会执行相应的方法来处理返回信息。
以上一个小节代码为例,方法接受一个回调函数,这个回调函数将在接收一个HTTP请求时被执行。但是在等待HTTP请求同时,线程仍然可以处理其他事件。
[h2]SOLID 设计原则[/h2]每当谈论微服务,我们总会提及模块化,而模块化归结于以下设计原则:
- 单一职责原则
- 开放封闭原则(对扩展开放、对修改关闭)
- 里氏替换原则(如果使用的是一个父类的话, 那么一定适用于其子类, 而察觉不出父类对象和子类对象的区别。也即是说,把父类替换成它的子类, 行为不会有变化。简单地说, 子类型必须能够替换掉它们的父类型。)
- 接口分离原则
- 依赖倒置原则(反转控制和依赖注入)
你应该将代码以模块的形式进行组织。一个模块应该是代码的聚合,他负责简单地处理某件事情,并且可以处理的很好,例如操作字符串。但是请注意,你的模块包含越多的函数(类、工具),它将越缺乏内聚性,这是应该极力避免的。
在Node.js中,每个JavaScript文件默认是一个模块。当然,也可以使用文件夹的形式组织模块,但是我们现在只关注的使用文件的形式:
- function contains(a, b) {
复制代码- return a.indexOf(b) > -1;
复制代码
- function stringToOrdinal(str) {
复制代码
- for (let i = 0, len = str.length; i {
复制代码- reply(null, { answer: ( msg.left + msg.right )})
复制代码
- return console.error(err);
复制代码 目前,这一切都发生在同一个过程中,没有网络流量。进程内函数调用也是一种消息传输!
该方法将新的操作模式添加到Seneca实例。它有两个参数:
- pattern:要在Seneca实例接收的任何JSON消息中匹配的属性模式。
- action:模式匹配消息时要执行的函数。
动作功能有两个参数:
- msg:匹配的入站消息(作为普通对象提供)。
- respond:一个回调函数,用于提供对消息的响应。
响应函数是带有标准error, result签名的回调函数。
让我们再把这一切放在一起:
- seneca.add({role: 'math', cmd: 'sum'}, function (msg, respond) {
复制代码- var sum = msg.left + msg.right
复制代码- respond(null, {answer: sum})
复制代码 在示例代码中,操作计算通过消息对象的和属性提供的两个数字的总和。并非所有消息都会生成结果,但由于这是最常见的情况,因此Seneca允许您通过回调函数提供结果。
总之,操作模式对此消息起作用:
- {role: 'math', cmd: 'sum', left: 1, right: 2}
复制代码 产生这个结果:
这些属性并没有什么特别之处。它们恰好是您用于模式匹配的那些。
该方法提交消息以进行操作。它有两个参数:
- msg:消息对象。
- response_callback:一个接收消息响应的函数(如果有)。
响应回调是您使用标准签名提供的功能。如果存在问题(例如,消息不匹配任何模式),则第一个参数是 Error对象。如果一切按计划进行,则第二个参数是结果对象。在示例代码中,这些参数只是打印到控制台:
- seneca.act({role: 'math', cmd: 'sum', left: 1, right: 2}, function (err, result) {
复制代码- if (err) return console.error(err)
复制代码 sum.js文件中的示例代码向您展示了如何在同一个Node.js进程中定义和调用操作模式。您很快就会看到如何在多个进程中拆分此代码。
[h3]匹配模式如何工作?[/h3]模式 - 与网络地址或主题相对 - 使扩展和增强系统变得更加容易。他们通过逐步添加新的微服务来实现这一点。
让我们的系统增加两个数相乘的能力。
我们希望看起来像这样的消息:
- {role: 'math', cmd: 'product', left: 3, right: 4}
复制代码 产生这样的结果:
您可以使用操作模式作为模板来定义新操作:
- seneca.add({role: 'math', cmd: 'product'}, function (msg, respond) {
复制代码- var product = msg.left * msg.right
复制代码- respond(null, { answer: product })
复制代码 你可以用完全相同的方式调用它:
- seneca.act({role: 'math', cmd: 'product', left: 3, right: 4}, console.log)
复制代码 在这里,您可以使用console.log快捷方式打印错误(如果有)和结果。运行此代码会产生:
把这一切放在一起,你得到:
- var seneca = require('seneca')()
复制代码
- seneca.add({role: 'math', cmd: 'sum'}, function (msg, respond) {
复制代码- var sum = msg.left + msg.right
复制代码- respond(null, {answer: sum})
复制代码
- seneca.add({role: 'math', cmd: 'product'}, function (msg, respond) {
复制代码- var product = msg.left * msg.right
复制代码- respond(null, { answer: product })
复制代码
- seneca.act({role: 'math', cmd: 'sum', left: 1, right: 2}, console.log)
复制代码- .act({role: 'math', cmd: 'product', left: 3, right: 4}, console.log)
复制代码 在上面的代码示例中,seneca.act调用链接在一起。Seneca提供链接API作为方便。链接的调用按顺序执行,但不是按顺序执行,因此它们的结果可以按任何顺序返回。
[h3]扩展模式以增加新功能[/h3]模式使您可以轻松扩展功能。您只需添加更多模式,而不是添加if语句和复杂逻辑。
让我们通过添加强制整数运算的能力来扩展加法动作。为此,您需要向消息对象添加一个新属性。然后,为具有此属性的邮件提供新操作:
- seneca.add({role: 'math', cmd: 'sum', integer: true}, function (msg, respond) {
复制代码- var sum = Math.floor(msg.left) + Math.floor(msg.right)
复制代码- respond(null, {answer: sum})
复制代码 现在,这条消息
- {role: 'math', cmd: 'sum', left: 1.5, right: 2.5, integer: true}
复制代码 产生这个结果:
- {answer: 3} // == 1 + 2, as decimals removed
复制代码 如果将两种模式添加到同一系统会发生什么?Seneca如何选择使用哪一个?更具体的模式总是赢。换句话说,具有最多匹配属性的模式具有优先权。
这里有一些代码来说明这一点:
- var seneca = require('seneca')()
复制代码
- seneca.add({role: 'math', cmd: 'sum'}, function (msg, respond) {
复制代码- var sum = msg.left + msg.right
复制代码- respond(null, {answer: sum})
复制代码
- // 下面两条消息都匹配 role: math, cmd: sum
复制代码
- seneca.act({role: 'math', cmd: 'sum', left: 1.5, right: 2.5}, console.log)
复制代码- seneca.act({role: 'math', cmd: 'sum', left: 1.5, right: 2.5, integer: true}, console.log)
复制代码
- seneca.add({role: 'math', cmd: 'sum', integer: true}, function (msg, respond) {
复制代码- var sum = Math.floor(msg.left) + Math.floor(msg.right)
复制代码- respond(null, { answer: sum })
复制代码
- //下面这条消息同样匹配 role: math, cmd: sum
复制代码- seneca.act({role: 'math', cmd: 'sum', left: 1.5, right: 2.5}, console.log)
复制代码
- // 但是,也匹配 role:math,cmd:sum,integer:true
复制代码- // 但是因为更多属性被匹配到,所以,它的优先级更高
复制代码- seneca.act({role: 'math', cmd: 'sum', left: 1.5, right: 2.5, integer: true}, console.log)
复制代码 它产生的输出是:
前两个.act调用都匹配动作模式。接下来,代码定义仅整数动作模式- role:math,cmd:sum,integer:true
复制代码 。在那之后,第三次调用.act与行动一致,但第四次调用- role:math,cmd:sum,integer:true
复制代码 。此代码还演示了您可以链接.add和.act调用。此代码在sum-integer.js文件中可用。
通过匹配更具体的消息类型,轻松扩展操作行为的能力是处理新的和不断变化的需求的简单方法。这既适用于您的项目正在开发中,也适用于实时项目且需要适应的项目。它还具有您不需要修改现有代码的优点。添加新代码来处理特殊情况会更安全。在生产系统中,您甚至不需要重新部署。您现有的服务可以保持原样运行。您需要做的就是启动新服务。
[h3]基于模式的代码复用[/h3]动作模式可以调用其他动作模式来完成它们的工作。让我们修改我们的示例代码以使用此方法:
- var seneca = require('seneca')()
复制代码
- seneca.add('role: math, cmd: sum', function (msg, respond) {
复制代码- var sum = msg.left + msg.right
复制代码- respond(null, {answer: sum})
复制代码
- seneca.add('role: math, cmd: sum, integer: true', function (msg, respond) {
复制代码- left: Math.floor(msg.left),
复制代码- right: Math.floor(msg.right)
复制代码
- seneca.act('role: math, cmd: sum, left: 1.5, right: 2.5',console.log)
复制代码
- // 匹配 role:math,cmd:sum,integer:true
复制代码- seneca.act('role: math, cmd: sum, left: 1.5, right: 2.5, integer: true', console.log)
复制代码 在此版本的代码中- ,role:math,cmd:sum,integer:true
复制代码 操作模式的定义使用先前定义的操作模式。但是,它首先修改消息以将left和right属性转换为整数。
在action函数内部,context变量this是对当前Seneca实例的引用。这是在行动中引用Seneca的正确方法,因为您获得了当前动作调用的完整上下文。这使您的日志更具信息性等。
此代码使用缩写形式的JSON来指定模式和消息。例如,对象文字形式
- {role: 'math', cmd: 'sum', left: 1.5, right: 2.5}
复制代码 变为:
- 'role: math, cmd: sum, left: 1.5, right: 2.5'
复制代码 这种格式jsonic,作为字符串文字提供,是一种方便的格式,可以使代码中的模式和消息更简洁。
sum-reuse.js文件中提供了上述示例的代码。
[h3]模式是唯一的[/h3]你定义的 Action 模式都是唯一了,它们只能触发一个函数,模式的解析规则如下:
- 更多我属性优先级更高
- 若模式具有相同的数量的属性,则按字母顺序匹配
这里有些例子:优先于 ,因为它有更多的属性。优先于如b之前谈到c的字母顺序。优先于如b之前谈到c的字母顺序。优先于 ,因为它有更多的属性。优先于 ,因为它有更多的属性。
很多时间,提供一种可以让你不需要全盘修改现有 Action 函数的代码即可增加它功能的方法是很有必要的,比如,你可能想为某一个消息增加更多自定义的属性验证方法,捕获消息统计信息,添加额外的数据库结果中,或者控制消息流速等。
我下面的示例代码中,加法操作期望 left 和 right 属性是有限数,此外,为了调试目的,将原始输入参数附加到输出的结果中也是很有用的,您可以使用以下代码添加验证检查和调试信息:
- const seneca = require('seneca')()
复制代码
- var sum = msg.left + msg.right
复制代码
- // 重写 role:math,cmd:sum with ,添加额外的功能
复制代码
- // bail out early if there's a problem
复制代码- if (!Number.isFinite(msg.left) ||
复制代码- !Number.isFinite(msg.right)) {
复制代码- return respond(new Error("left 与 right 值必须为数字。"))
复制代码
- // 调用上一个操作函数 role:math,cmd:sum
复制代码
- }, function(err, result) {
复制代码- if (err) return respond(err)
复制代码
- result.info = msg.left + '+' + msg.right
复制代码
- // 增加了的 role:math,cmd:sum
复制代码- .act('role:math,cmd:sum,left:1.5,right:2.5',
复制代码- console.log // 打印 { answer: 4, info: '1.5+2.5' }
复制代码 seneca 实例提供了一个名为 prior 的方法,让可以在当前的 action 方法中,调用被其重写的旧操作函数。
prior 函数接受两个参数:
- msg:消息体
- response_callback:回调函数
在上面的示例代码中,已经演示了如何修改入参与出参,修改这些参数与值是可选的,比如,可以再添加新的重写,以增加日志记录功能。
在上面的示例中,也同样演示了如何更好的进行错误处理,我们在真正进行操作之前,就验证的数据的正确性,若传入的参数本身就有错误,那么我们直接就返回错误信息,而不需要等待真正计算的时候由系统去报错了。错误消息应该只被用于描述错误的输入或者内部失败信息等,比如,如果你执行了一些数据库的查询,返回没有任何数据,这并不是一个错误,而仅仅只是数据库的事实的反馈,但是如果连接数据库失败,那就是一个错误了。 上面的代码可以在 sum-valid.js 文件中找到。
[h3]使用插件组织模式[/h3]一个 seneca 实例,其实就只是多个 Action Patterm 的集合而已,你可以使用命名空间的方式来组织操作模式,例如在前面的示例中,我们都使用了 role: math,为了帮助日志记录和调试, Seneca 还支持一个简约的插件支持。
同样,Seneca插件只是一组操作模式的集合,它可以有一个名称,用于注释日志记录条目,还可以给插件一组选项来控制它们的行为,插件还提供了以正确的顺序执行初始化函数的机制,例如,您希望在尝试从数据库读取数据之前建立数据库连接。
简单来说,Seneca插件就只是一个具有单个参数选项的函数,你将这个插件定义函数传递给 seneca.use 方法,下面这个是最小的Seneca插件(其实它什么也没做!):
- function minimal_plugin(options) {
复制代码
- .use(minimal_plugin, {foo: 'bar'})
复制代码 seneca.use 方法接受两个参数:
- plugin :插件定义函数或者一个插件名称;
- options :插件配置选项
上面的示例代码执行后,打印出来的日志看上去是这样的:
- {"kind":"notice","notice":"hello seneca 3qk0ij5t2bta/1483584697034/62768/3.2.2/-","level":"info","when":1483584697057}
复制代码- (node:62768) DeprecationWarning: 'root' is deprecated, use 'global'
复制代码 Seneca 还提供了详细日志记录功能,可以提供为开发或者生产提供更多的日志信息,通常的,日志级别被设置为 INFO,它并不会打印太多日志信息,如果想看到所有的日志信息,试试以下面这样的方式启动你的服务:
- node minimal-plugin.js --seneca.log.all
复制代码 会不会被吓一跳?当然,你还可以过滤日志信息:
- node minimal-plugin.js --seneca.log.all | grep plugin:define
复制代码 通过日志我们可以看到, seneca 加载了很多内置的插件,比如 basic、transport、web 以及 mem-store,这些插件为我们提供了创建微服务的基础功能,同样,你应该也可以看到 minimal_plugin 插件。
现在,让我们为这个插件添加一些操作模式:
- this.add('role:math,cmd:sum', function (msg, respond) {
复制代码- respond(null, { answer: msg.left + msg.right })
复制代码
- this.add('role:math,cmd:product', function (msg, respond) {
复制代码- respond(null, { answer: msg.left * msg.right })
复制代码
- .act('role:math,cmd:sum,left:1,right:2', console.log)
复制代码 运行 math-plugin.js 文件,得到下面这样的信息:
看打印出来的一条日志:
- "actid": "7ubgm65mcnfl/uatuklury90r",
复制代码- "id": "7ubgm65mcnfl/uatuklury90r",
复制代码- "pattern": "cmd:sum,role:math",
复制代码- "action": "(bjx5u38uwyse)",
复制代码- "plugin_fullname": "math",
复制代码- "pattern": "cmd:sum,role:math",
复制代码- "pattern": "cmd:sum,role:math",
复制代码 所有的该插件的日志都被自动的添加了 plugin 属性。
在 Seneca 的世界中,我们通过插件组织各种操作模式集合,这让日志与调试变得更简单,然后你还可以将多个插件合并成为各种微服务,在接下来的章节中,我们将创建一个 math 服务。
插件通过需要进行一些初始化的工作,比如连接数据库等,但是,你并不需要在插件的定义函数中去执行这些初始化,定义函数被设计为同步执行的,因为它的所有操作都是在定义一个插件,事实上,你不应该在定义函数中调用 seneca.act 方法,只调用 seneca.add 方法。
要初始化插件,你需要定义一个特殊的匹配模式 init: ,对于每一个插件,将按顺序调用此操作模式,init 函数必须调用其 callback 函数,并且不能有错误发生,如果插件初始化失败,则 Seneca 会立即退出 Node 进程。所以的插件初始化工作都必须在任何操作执行之前完成。
为了演示初始化,让我们向 math 插件添加简单的自定义日志记录,当插件启动时,它打开一个日志文件,并将所有操作的日志写入文件,文件需要成功打开并且可写,如果这失败,微服务启动就应该失败。
- this.add('role:math,cmd:sum', sum)
复制代码- this.add('role:math,cmd:product', product)
复制代码
- this.add('init:math', init)
复制代码
- function init(msg, respond) {
复制代码- fs.open(options.logfile, 'a', function (err, fd) {
复制代码
- // 如果不能读取或者写入该文件,则返回错误,这会导致 Seneca 启动失败
复制代码- if (err) return respond(err)
复制代码
- function sum(msg, respond) {
复制代码- var out = { answer: msg.left + msg.right }
复制代码- log('sum '+msg.left+'+'+msg.right+'='+out.answer+'\n')
复制代码
- function product(msg, respond) {
复制代码- var out = { answer: msg.left * msg.right }
复制代码- log('product '+msg.left+'*'+msg.right+'='+out.answer+'\n')
复制代码
- return function (entry) {
复制代码- fs.write(fd, new Date().toISOString()+' '+entry, null, 'utf8', function (err) {
复制代码- if (err) return console.log(err)
复制代码
- fs.fsync(fd, function (err) {
复制代码- if (err) return console.log(err)
复制代码
- .use(math, {logfile:'./math.log'})
复制代码- .act('role:math,cmd:sum,left:1,right:2', console.log)
复制代码 在上面这个插件的代码中,匹配模式被组织在插件的顶部,以便它们更容易被看到,函数在这些模式下面一点被定义,您还可以看到如何使用选项提供自定义日志文件的位置(不言而喻,这不是生产日志!)。
初始化函数 init 执行一些异步文件系统工作,因此必须在执行任何操作之前完成。如果失败,整个服务将无法初始化。要查看失败时的操作,可以尝试将日志文件位置更改为无效的,例如 /math.log。
以上代码可以在 math-plugin-init.js 文件中找到。
[h3]创建微服务[/h3]现在让我们把 math 插件变成一个真正的微服务。首先,你需要组织你的插件。math 插件的业务逻辑 ---- 即它提供的功能,与它以何种方式与外部世界通信是分开的,你可能会暴露一个Web服务,也有可能在消息总线上监听。
将业务逻辑(即插件定义)放在其自己的文件中是有意义的。Node.js 模块即可完美的实现,创建一个名为 math.js 的文件,内容如下:
- module.exports = function math(options) {
复制代码
- this.add('role:math,cmd:sum', function sum(msg, respond) {
复制代码- respond(null, { answer: msg.left + msg.right })
复制代码
- this.add('role:math,cmd:product', function product(msg, respond) {
复制代码- respond(null, { answer: msg.left * msg.right })
复制代码
- this.wrap('role:math', function (msg, respond) {
复制代码- msg.left = Number(msg.left).valueOf()
复制代码- msg.right = Number(msg.right).valueOf()
复制代码 然后,我们可以在需要引用它的文件中像下面这样添加到我们的微服务系统中:
- // 下面这两种方式都是等价的(还记得我们前面讲过的 `seneca.use` 方法的两个参数吗?)
复制代码- .use(require('./math.js'))
复制代码- .act('role:math,cmd:sum,left:1,right:2', console.log)
复制代码
- .use('math') // 在当前目录下找到 `./math.js`
复制代码- .act('role:math,cmd:sum,left:1,right:2', console.log)
复制代码 seneca.wrap 方法可以匹配一组模式,同使用相同的动作扩展函数覆盖至所有被匹配的模式,这与为每一个组模式手动调用 seneca.add 去扩展可以得到一样的效果,它需要两个参数:
- pin :模式匹配模式
- action :扩展的 action 函数
pin 是一个可以匹配到多个模式的模式,它可以匹配到多个模式,比如 role:math 这个 pin 可以匹配到 role:math, cmd:sum 与 role:math, cmd:product。
在上面的示例中,我们在最后面的 wrap 函数中,确保了,任何传递给 role:math 的消息体中 left 与 right 值都是数字,即使我们传递了字符串,也可以被自动的转换为数字。
有时,查看 Seneca 实例中有哪些操作是被重写了是很有用的,你可以在启动应用时,加上 --seneca.print.tree 参数即可,我们先创建一个 math-tree.js 文件,填入以下内容:
然后再执行它:
- node math-tree.js --seneca.print.tree
复制代码- {"kind":"notice","notice":"hello seneca abs0eg4hu04h/1483589278500/65316/3.2.2/-","level":"info","when":1483589278522}
复制代码- (node:65316) DeprecationWarning: 'root' is deprecated, use 'global'
复制代码- Seneca action patterns for instance: abs0eg4hu04h/1483589278500/65316/3.2.2/-
复制代码- │ └── # math, (15fqzd54pnsp),
复制代码- │ # math, (qqrze3ub5vhl), sum
复制代码- └── # math, (qnh86mgin4r6),
复制代码- # math, (4nrxi5f6sp69), product
复制代码 从上面你可以看到很多的键/值对,并且以树状结构展示了重写,所有的 Action 函数展示的格式都是 #plugin, (action-id), function-name。
但是,到现在为止,所有的操作都还存在于同一个进程中,接下来,让我们先创建一个名为 math-service.js 的文件,填入以下内容:
` 然后启动该脚本,即可启动我们的微服务,它会启动一个进程,并通过 10101 端口监听HTTP请求,它不是一个 Web 服务器,在此时, HTTP 仅仅作为消息的传输机制。
你现在可以访问 http://localhost:10101/act?ro... 即可看到结果,或者使用 curl 命令:
- curl -d '{"role":"math","cmd":"sum","left":1,"right":2}' http://localhost:10101/act
复制代码 两种方式都可以看到结果:
接下来,你需要一个微服务客户端 math-client.js:
- .act('role:math,cmd:sum,left:1,right:2',console.log)
复制代码 打开一个新的终端,执行该脚本:
- null { answer: 3 } { id: '7uuptvpf8iff/9wfb26kbqx55',
复制代码- accept: '043di4pxswq7/1483589685164/65429/3.2.2/-',
复制代码- client_recv: 1483589898390 } }
复制代码 在 Seneca 中,我们通过 seneca.listen 方法创建微服务,然后通过 seneca.client 去与微服务进行通信。在上面的示例中,我们使用的都是 Seneca 的默认配置,比如 HTTP 协议监听 10101 端口,但 seneca.listen 与 seneca.client 方法都可以接受下面这些参数,以达到定抽的功能:
- port :可选的数字,表示端口号;
- host :可先的字符串,表示主机名或者IP地址;
- spec :可选的对象,完整的定制对象
注意:在 Windows 系统中,如果未指定 host, 默认会连接 0.0.0.0,这是没有任何用处的,你可以设置 host 为 localhost。
只要 client 与 listen 的端口号与主机一致,它们就可以进行通信:
- seneca.client(8080) → seneca.listen(8080)
- seneca.client(8080, '192.168.0.2') → seneca.listen(8080, '192.168.0.2')
- seneca.client({ port: 8080, host: '192.168.0.2' }) → seneca.listen({ port: 8080, host: '192.168.0.2' })
Seneca 为你提供的 无依赖传输 特性,让你在进行业务逻辑开发时,不需要知道消息如何传输或哪些服务会得到它们,而是在服务设置代码或配置中指定,比如 math.js 插件中的代码永远不需要改变,我们就可以任意的改变传输方式。
虽然 HTTP 协议很方便,但是并不是所有时间都合适,另一个常用的协议是 TCP,我们可以很容易的使用 TCP 协议来进行数据的传输,尝试下面这两个文件:
math-service-tcp.js :
math-client-tcp.js
- .act('role:math,cmd:sum,left:1,right:2',console.log)
复制代码 默认情况下, client/listen 并未指定哪些消息将发送至哪里,只是本地定义了模式的话,会发送至本地的模式中,否则会全部发送至服务器中,我们可以通过一些配置来定义哪些消息将发送到哪些服务中,你可以使用一个 pin 参数来做这件事情。
让我们来创建一个应用,它将通过 TCP 发送所有 role:math 消息至服务,而把其它的所有消息都在发送至本地:
math-pin-service.js:
- .listen({ type: 'tcp', pin: 'role:math' })
复制代码 math-pin-client.js:
- .add('say:hello', function (msg, respond){ respond(null, {text: "Hi!"}) })
复制代码
- .client({ type: 'tcp', pin: 'role:math' })
复制代码
- .act('role:math,cmd:sum,left:1,right:2',console.log)
复制代码
- .act('say:hello',console.log)
复制代码 你可以通过各种过滤器来自定义日志的打印,以跟踪消息的流动,使用 --seneca... 参数,支持以下配置:
- date-time:log 条目何时被创建;
- seneca-id:Seneca process ID;
- level:DEBUG、INFO、WARN、ERROR 以及 FATAL 中任何一个;
- type:条目编码,比如 act、plugin 等;
- plugin:插件名称,不是插件内的操作将表示为 root$;
- case:条目的事件:IN、ADD、OUT 等
- action-id/transaction-id:跟踪标识符,在网络中永远保持一致;
- pin:action 匹配模式;
- message:入/出参消息体
如果你运行上面的进程,使用了 --seneca.log.all,则会打印出所有日志,如果你只想看 math 插件打印的日志,可以像下面这样启动服务:
- node math-pin-service.js --seneca.log=plugin:math
复制代码 [h3]Web 服务集成[/h3]Seneca不是一个Web框架。但是,您仍然需要将其连接到您的Web服务API,你永远要记住的是,不要将你的内部行为模式暴露在外面,这不是一个好的安全的实践,相反的,你应该定义一组API模式,比如用属性 role:api,然后你可以将它们连接到你的内部微服务。
下面是我们定义 api.js 插件。
- module.exports = function api(options) {
复制代码
- var validOps = { sum:'sum', product:'product' }
复制代码
- this.add('role:api,path:calculate', function (msg, respond) {
复制代码- var operation = msg.args.params.operation
复制代码- var left = msg.args.query.left
复制代码- var right = msg.args.query.right
复制代码- cmd: validOps[operation],
复制代码
- this.add('init:api', function (msg, respond) {
复制代码- this.act('role:web',{routes:{
复制代码- calculate: { GET:true, suffix:'/{operation}' }
复制代码
然后,我们使用 hapi 作为Web框架,建了 hapi-app.js 应用:
- const Hapi = require('hapi');
复制代码- const Seneca = require('seneca');
复制代码- const SenecaWeb = require('seneca-web');
复制代码
- adapter: require('seneca-web-adapter-hapi'),
复制代码- const server = new Hapi.Server();
复制代码
- handler: (request, reply) => {
复制代码- const routes = server.table()[0].table.map(route => {
复制代码- method: route.method.toUpperCase(),
复制代码- description: route.settings.description,
复制代码- tags: route.settings.tags,
复制代码- vhost: route.settings.vhost,
复制代码- cors: route.settings.cors,
复制代码- jsonp: route.settings.jsonp,
复制代码
- const server = seneca.export('web/context')();
复制代码- server.log('server started on: ' + server.info.uri);
复制代码 启动 hapi-app.js 之后,访问 http://localhost:3000/routes ,你便可以看到下面这样的信息:
- "path": "/api/calculate/{operation}",
复制代码 这表示,我们已经成功的将模式匹配更新至 hapi 应用的路由中。访问 http://localhost:3000/api/cal... ,将得到结果:
在上面的示例中,我们直接将 math 插件也加载到了 seneca 实例中,其实我们可以更加合理的进行这种操作,如 hapi-app-client.js 文件所示:
- .client({type: 'tcp', pin: 'role:math'})
复制代码- const server = seneca.export('web/context')();
复制代码- server.log('server started on: ' + server.info.uri);
复制代码 我们不注册 math 插件,而是使用 client 方法,将 role:math 发送给 math-pin-service.js 的服务,并且使用的是 tcp 连接,没错,你的微服务就是这样成型了。
注意:永远不要使用外部输入创建操作的消息体,永远显示地在内部创建,这可以有效避免注入攻击。
在上面的的初始化函数中,调用了一个 role:web 的模式操作,并且定义了一个 routes 属性,这将定义一个URL地址与操作模式的匹配规则,它有下面这些参数:
- prefix:URL 前缀
- pin:需要映射的模式集
- map:要用作 URL Endpoint 的 pin 通配符属性列表
你的URL地址将开始于 /api/。这个 pin 表示,映射任何有 role="api" 键值对,同时 path 属性被定义了的模式,在本例中,只有符合该模式。
map 属性是一个对象,它有一个 calculate 属性,对应的URL地址开始于:/api/calculate。
按着, calculate 的值是一个对象,它表示了 HTTP 的 GET 方法是被允许的,并且URL应该有参数化的后缀(后缀就类于 hapi 的 route 规则中一样)。
所以,你的完整地址是- /api/calculate/{operation}
复制代码 。
然后,其它的消息属性都将从 URL query 对象或者 JSON body 中获得,在本示例中,因为使用的是 GET 方法,所以没有 body。
SenecaWeb 将会通过 msg.args 来描述一次请求,它包括:
- body:HTTP 请求的 payload 部分;
- query:请求的 querystring;
- params:请求的路径参数。
现在,启动前面我们创建的微服务:- node math-pin-service.js--seneca.log=plugin:math
复制代码 然后再启动我们的应用:- node hapi-app.js--seneca.log=plugin:web,plugin:api
复制代码 访问下面的地址:
http://localhost:3000/api/cal... 得到 {"answer":6}
http://localhost:3000/api/cal... 得到 {"answer":5}
[h2]PM2:node服务部署(服务集群)、管理与监控[/h2]启动
- -w --watch:监听目录变化,如变化则自动重启应用
- --ignore-file:监听目录变化时忽略的文件。如pm2 start rpcserver.js --watch --ignore-watch="rpcclient.js"
- -n --name:设置应用名字,可用于区分应用
- -i --instances:设置应用实例个数,0与max相同
- -f --force:强制启动某应用,常常用于有相同应用在运行的情况
- -o --output :标准输出日志文件的路径
- -e --error :错误输出日志文件的路径
- --env :配置环境变量
如- pm2 start rpc_server.js-w-i max-n s1--ignore-watch="rpc_client.js"-e./server_error.log-o./server_info.log
复制代码在cluster-mode,也就是-i max下,日志文件会自动在后面追加-${index}保证不重复 [h3]其他简单且常用命令[/h3]- pm2 stop appname|appid
- pm2 restart appname|appid
- pm2 delete appname|appid
- pm2 show appname|appid OR pm2 describe appname|appid
- pm2 list
- pm2 monit
- pm2 logs appname|appid --lines --err
[h3]Graceful Stop[/h3]- process.on('SIGINT', () => {
复制代码- connection && connection.close()
复制代码 当进程结束前,程序会拦截SIGINT信号从而在进程即将被杀掉前去断开数据库连接等等占用内存的操作后再执行process.exit()从而优雅的退出进程。(如在1.6s后进程还未结束则继续发送SIGKILL信号强制进程结束)
[h3]Process File[/h3]ecosystem.config.js
- max_memory_restart: '150M',
复制代码- source_map_support: true,
复制代码- // 进程SIGINT命令时间限制,即进程必须在监听到SIGINT信号后必须在以下设置时间结束进程
复制代码- // 当启动异常后不尝试重启,运维人员尝试找原因后重试
复制代码- // 在Keymetrics dashboard中执行pull/upgrade操作后执行的命令队列
复制代码- post_update: ['npm install'],
复制代码- ignore_watch: ['node_modules']
复制代码
- function GeneratePM2AppConfig({ name = '', script = '', error_file = '', out_file = '', exec_mode = 'fork', instances = 1, args = "" }) {
复制代码- script: script || `${name}.js`,
复制代码- error_file: error_file || `${name}-err.log`,
复制代码- out_file: out_file|| `${name}-out.log`,
复制代码- exec_mode: instances > 1 ? 'cluster' : 'fork',
复制代码
- script: './rpc_client.js'
复制代码
- script: './rpc_server.js',
复制代码
- pm2 start ecosystem.config.js
复制代码
避坑指南:processFile文件命名建议为*.config.js格式。否则后果自负。 [h2]小结[/h2]在本章中,你掌握了Seneca 和 PM2 的基础知识,你可以搭建一个面向微服务的系统。
[h2]参考[/h2]- senecajs:http://senecajs.org
- 《Node.js微服务》(美)David Gonzalez(大卫 冈萨雷斯) 著
- senecajs 快速开始文档:http://senecajs.org/getting-started/
- Seneca :NodeJS 微服务框架入门指南:https://segmentfault.com/a/1190000008501410#articleHeader7
推荐阅读
(点击标题可跳转阅读)
Node.js 微服务实践(一)
Node.js 项目拆包工程化
Node 12 值得关注的新特性
觉得本文对你有帮助?请分享给更多人
关注「前端大全」加星标,提升前端技能
好文章,我在看
|
|