gopool v0.2.0

gopool

利用线程池执行您的 Nodejs 程序, 并且保持多线程代码编写在原有文件中.

起因

在一个生产实例中，我们有一台机器使用 pm2 启动了大概 17 个 Cluster；这导致于空闲状态下也会有 2.5GB 的 node 内存开销，Cluster 的内存复用率较低，并且无法根据请求量弹性的调整集群数量。

目标

• 守护进程
• 更好的 worker_threads 开发体验
• 弹性调整进程数量
• 兼容 I/O 密集和 CPU 密集型的场景
• 自带一套极简的性能监控功能(未来目标)

约定

• 为了降低 Master 的工作量, 前后端通讯参数仅用 query 和 body

结构

+--------+     +--------+     +--------------------+
| daemon | --> | master | --> | threads-worker x n |
+--------+     +--------+     +--------------------+

• deamon 是主进程, 它做的仅仅是守护 master 进程, 确保如果 master 消亡会进行重启
• master 是多线程的管家, 它也是整个程序的对外的接口, 使用 fastify 进行路由注册和管理, 使用 piscina 进行多线程工作派发
• threads-worker 根据任务量自动伸缩的线程, 我们的 99%的代码都在此, 由于 nodejs 多线程的加载方式限制, 我们所有代码应该是惰性函数.

Performace

gopool 基于 fastify 和 piscina.

诚然，使用事件循环明显比使用线程有着更高的 I/O 性能， 所以使用此方案在纯 I/O 密集任务会有所下降，但是依然保持在一个非常高的水准；而在计算密集型的场景，性能接近于等量 CPU 的 Cluster 启动。

内存方面，相较启动大量 Cluster, gopool 的内存占用率会大幅度下降；相较于仅启动单一 nodejs， gopool 有两倍的内存开销。

大白话解释: 牺牲少部分原本就过剩的 I/O 性能, 换取多核 CPU 的计算性能榨取, 在 I/O 性能、计算性能、内存利用率上争取综合最大化.

以下是一些测试数据，测试机型: Apple M1 pro

空闲

简单请求

查询数据库，I/O 密集型

I/O 密集型 + CPU 密集型

在每个请求中都进行一次 fibonacci(30) 的计算

我们可以看到，对于纯 I/O 密集型的任务，事件轮训是最高效的，Cluster 、worker_threads 都有一定的分流开销，而要兼顾一定的计算性能，使用 worker_threads 是可以接受的。

约定

• 路由层由 gopool 管控

使用

首先编写 worker.js:

const { gopool } = require("gopool");
const { config } = require("dotenv");

// 向 gopool 注册路由, 这些路由会被 master 记录
gopool.get("/v1/hello", async ({body, ctx}) => {
  return { ...body };
});
gopool.post("/v1/world", ({body, ctx}) => {
  return { ...body };
});

// 在master所有路由注册完之后，在master启动服务
gopool.onMaster = ({app, ctx}) => {
  // env环境变量会由master传递给每个线程
  config();

  // 耗时的初始化请在master进行, 可以绑定在 ctx 上，ctx会传递给每个线程
  // 注意不可绑定函数对象至 ctx 中
  ctx.somebody = {
    hello:"world"
  };

  // 此任务由master响应
  app.get("/master/ping", (req) => {
    return { query: req.query };
  });
  console.log(`listen: http://${host}:${port}`);
  await app.listen({ port, host });
};

// 使用多线程启动服务
gopool.startWithThreadsPool();

// 降级, 使用单线程启动服务
// gopool.startWithSingle();

// 最后需要导出 gopool 对象
// masterServe 会接管路由，并且匹配多线程任务
module.exports = gopool;

获取 headers

由于需要跨线程通讯，headers 尽可能仅传递必要的信息，所以 gopool 提供了一个 headersGetter 的方法

gopool.headerGetter = (headers) => {
  // 挑选必要的header
  return {
    "user-agent": headers["user-agent"],
  };
};

gopool.get("/v1/hello", async ({ headers }) => {
  return { hello: Date.now(), headers };
});

降级到单线程模式

可以通过取消导出 gopool, 改用 startInWorker 的方式, 改为传统单线程的运行方式。

修改 index.js

// 保持上面原有代码
gopool.startWithSingle();

// 取消导出 gopool
// module.exports = gopool;

API

CLI API

执行参数：

interface Options {
  filename: string;
  infoUrl?: string;
  timeout?: number;
  minThreads?: number;
  maxThreads?: number;
  maxQueue?: number;
  idleTimeout?: number;
}