pm2手册

简介

PM2是node进程管理工具，可以利用它来简化很多node应用管理的繁琐任务，如性能监控、自动重启、负载均衡等，而且使用非常简单。

安装

全局安装，简直不能更简单。

npm install -g pm2
复制代码

启动

pm2 start app.js --watch -i 2
复制代码

参数说明：

--watch：监听应用目录的变化，一旦发生变化，自动重启。如果要精确监听、不见听的目录，最好通过配置文件。
-i --instances：启用多少个实例，可用于负载均衡。如果-i 0或者-i max，则根据当前机器核数确定实例数目。
--ignore-watch：排除监听的目录/文件，可以是特定的文件名，也可以是正则。比如--ignore-watch="test node_modules "some scripts""
-n --name：应用的名称。查看应用信息的时候可以用到。
-o --output <path>：标准输出日志文件的路径。
-e --error <path>：错误输出日志文件的路径。
--interpreter <interpreter>：the interpreter pm2 should use for executing app (bash, python...)。比如你用的coffee script来编写应用。

重启

pm2 restart app.js
复制代码

停止

停止特定的应用。可以先通过pm2 list获取应用的名字（--name指定的）或者进程id。

pm2 stop app_name|app_id

复制代码

如果要停止所有应用，可以

pm2 stop all
复制代码

删除

类似pm2 stop，如下

pm2 delete app_name|app_id
pm2 delete all
复制代码

查看进程状态

pm2 list
复制代码

查看某个进程的信息

$ pm2 descripe app_name | app_id
复制代码

监控

我们可以使用以下命令，查看当前通过 pm2 运行的进程的状态；

$ pm2 monit
复制代码

负载均衡

命令如下，表示开启三个进程。如果-i 0，则会根据机器当前核数自动开启尽可能多的进程。

pm2 start app.js -i 3 # 开启三个进程
pm2 start app.js -i max # 根据机器CPU核数，开启对应数目的进程 
复制代码

日志查看

除了可以打开日志文件查看日志外，还可以通过pm2 logs来查看实时日志。这点对于线上问题排查非常重要。

比如某个node服务突然异常重启了，那么可以通过pm2提供的日志工具来查看实时日志，看是不是脚本出错之类导致的异常重启。

pm2 logs
复制代码

内存使用超过上限自动重启

如果想要你的应用，在超过使用内存上限后自动重启，那么可以加上--max-memory-restart参数。（有对应的配置项）

pm2 start big-array.js --max-memory-restart 20M
复制代码

更新pm2

$ pm2 save # 记得保存进程状态
$ npm install pm2 -g
$ pm2 update
复制代码

在线监控系统

master 挂了的话，pm2 如何处理?

Node.js 原生集群模式

Node.js 提供了 集群模块 cluster，简单讲就是复制一些可以共享 TCP 连接的工作进程。

工作原理

集群模块会创建一个 master 主进程，然后复制任意多份程序并启动，这叫做工作进程。

工作进程通过 IPC 频道进行通信并且使用了 Round-robin algorithm 算法进行工作调度以此实现负载均衡。

Round-robin 调度策略主要是 master 主进程负责接收所有的连接并派发给下面的各个工作进程。

var cluster = require("cluster");
var http = require("http");
var os = require("os");

核数
var numCPUs = os.cpus().length;

if (cluster.isMaster) {
  // Master:
  // Let's fork as many workers as you have CPU cores
  // 创建多个工作线程
  for (var i = 0; i < numCPUs; ++i) {
    cluster.fork();
  }
} else {
  // Worker:
  // Let's spawn a HTTP server
  // (Workers can share any TCP connection.
  //  In this case its a HTTP server)

  http
    .createServer(function (req, res) {
      res.writeHead(200);
      res.end("hello world");
    })
    .listen(8080);
}
复制代码

你可以不受 CPU 核心限制的创建任意多个工作进程。

用原生方法有些麻烦而且还需要处理，如果某个工作线程挂掉了等额外的逻辑。

pm2 的方式

pm2 内置了处理上述的逻辑，不用再写这么多繁琐的代码了

pm2 start app.js -i 4

-i 表示实例程序的个数---就是工作线程。如果i为0表示，会根据当前CPU核心数创建

这样的一行代码就可以啦！
复制代码

保持程序不中断运行如果有任何工作进程意外挂掉了，pm2 会立即重启他们，当前你可以在任何时候重启，只需要pm2 restart all
实时调整集群数量你可以使用命令 pm2 scale <appName> <n>调整你的线程数量，如 pm2 scale app +3 会在当前基础上加 3 个工作线程
在生产环境中让程序永不中断 PM2 reload <appName> 命令一个接一个的重启工作线程，在新的工作线程启动后才结束老的工作线程。

这种方式可以保持你的 Node 程序始终是运行状态。即使在生产环境下部署了新的代码补。

也可以使用 gracefulReload 命令达到同样的目的，它不会立即结束工作线程，而是通过 IPC 向它发送关闭信号，这样它就可以关闭正在进行的连接，还可以在退出之前执行一些自定义任务，这种方式更优雅。

process.on("message", function (msg) {
  if (msg === "shutdown") {
    close_all_connections();
    delete_cache();
    server.close();
    process.exit(0);
  }
});
复制代码

pm2 依据什么重启服务?

pm2 是一个带有负载均衡功能的 node 应用的进程管理器。我们都知道 node.js 是单进程执行的，当程序出现错误死掉之后需要能够自动，这时候就需要 pm2 了，当然进程管理工具有很多，例如 forever 等等；

主要特性

启动多子进程，充分使用 CPU
子进程之间负载均衡
0 秒重启
界面友好
提供进程交互接口

依据什么重启服务

pm2 采用心跳检测查看子进程是否处于活跃状态，每隔数秒向子进程发送心跳包，子进程如果不回复，那么调用 kill 杀死这个进程，然后再重新 cluster.fork() 一个新的进程，子进程可以监听到错误事件，这个时候可以发送消息给主进程，请求杀死自己，并且主进程此时重新调用 cluster.fork() 一个新的子进程

目录

简介

安装

启动

重启

停止

删除