pm2.md 7.1 KB

PM2

https://github.com/Unitech/pm2

当前使用场景:产品环境守护进程。

常用命令

启动项目

pm2 start xxx.js   #直接启动入口文件

pm2 start xxx.json #通过配置启动

配置文件参考:

[{
    "name": "app",
    "script": "babel.js",
    "log_date_format": "YYYY-MM-DD HH:mm:ss Z",
    "cwd": "/home/project",
    "error_file": "/home/project/logs/app.err.log",
    "out_file": "/home/project/logs/app.out.log",
    "max_memory_restart": "800M",
    "instances": 0,
    "exec_mode": "cluster",
    "merge_logs": true,
    "env": {
        "NODE_ENV": "production"
    }
},{
  "script" : "./examples/child.js",
  "error_file" : "errLog.log",
  "out_file" : "outLog.log",
  "pid_file" : "child",
  "instances" : "4",
  "min_uptime" : "10",
  "max_restarts" : "4"
},{
  "script" : "examples/env.js",
  "error_file" : "errEcho.log",
  "out_file" : "outEcho.log",
  "name" : "ok",
  "pid_file" : "echo.pid",
  "max" : "1",
  "exec_mode" : "cluster_mode",
  "port" : "9001",
  "env_variable" : "TOTO",
  "TEST_VARIABLE" : "YESSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSIR"
}]

重启项目

pm2 restart #PID# #重启一个进程

pm2 restart app-name #重启一个应用

pm2 restart all #重启所有项目

停止

pm2 stop #PID#

pm2 stop app-name

终止

pm2 delete app-name #删除一个进程

pm2 kill #终止所有进程

开机自启

pm2 startup

参考官方文档获取详细使用说明。

自动重启

设置内存使用过高上限,可以通过配置文件这一项:

{
  "max_memory_restart": "800M"
}

PM2是一个很好的工具,提供了max-memory-restart内存溢出重启的功能。

但美中不足的是,没有CPU限制重启的功能。

同时,也无法进行远程手动重启。但好在,PM2提供了JSON格式列表输出,让我们可以自己去写一些守护进程,或者整合到已有的运维管理系统中。

pm2 jlist

结果会是这样的json:

[
  {
      "pid": 28701,
      "name": "xxxx",
      "pm2_env": {
          "name": "xxxx",
          "max_memory_restart": 838860800,
          "instances": 0,
          "cwd": "/xxxx/project",
          "merge_logs": true,
          "vizion": true,
          "pmx": true,
          "automation": true,
          "autorestart": true,
          "treekill": true,
          "env": {
              "PM2_JSON_PROCESSING": "true",
              "LSCOLORS": "Gxfxcxdxbxegedabagacad",
              "LESS": "-R",
              "PAGER": "less",
              "SSH_TTY": "/dev/pts/1",
              "SSH_CLIENT": "218.94.29.190 53115 22",
              "SHELL": "/bin/bash",
              "TERM": "xterm-256color",
              "XDG_SESSION_ID": "814",
              "NODE_ENV": "production",
              "max_memory_restart": 838860800,
              "instances": 0,
              "merge_logs": true,
              "vizion": true,
              "pmx": true,
              "automation": true,
              "autorestart": true,
              "treekill": true,
              "log_date_format": "YYYY-MM-DD HH:mm:ss Z",
              "exec_mode": "cluster_mode",
              "node_args": [],
              "exec_interpreter": "node",
              "pm_out_log_path": "/xxxxx/logs/fish.out.log",
              "pm_err_log_path": "/xxxxx/logs/fish.err.log"
          },
          "log_date_format": "YYYY-MM-DD HH:mm:ss Z",
          "exec_mode": "cluster_mode",
          "node_args": [],
          "pm_exec_path": "/xxxx/babel.js",
          "pm_cwd": "/xxxxx/project",
          "exec_interpreter": "node",
          "pm_out_log_path": "/xxxxxx/xxx.out.log",
          "pm_err_log_path": "/xxxxxx/xxx.err.log",
          "NODE_APP_INSTANCE": 0,
          "vizion_running": false,
          "PM2_JSON_PROCESSING": "true",
          "LESSCLOSE": "/usr/bin/lesspipe %s %s",
          "XDG_RUNTIME_DIR": "/run/user/1000",
          "LESSOPEN": "| /usr/bin/lesspipe %s",
          "LC_CTYPE": "zh_CN.UTF-8",
          "SSH_TTY": "/dev/pts/1",
          "SHELL": "/bin/bash",
          "NODE_ENV": "production",
          "fish": "{}",
          "status": "online",
          "pm_uptime": 1472561001434,
          "axm_actions": [],
          "axm_monitor": {
              "Loop delay": {
                  "value": "0.92ms",
                  "agg_type": "avg",
                  "alert": {}
              }
          },
          "axm_options": {
              "http": false,
              "http_latency": 200,
              "http_code": 500,
              "ignore_routes": [],
              "profiling": true,
              "errors": true,
              "alert_enabled": true,
              "custom_probes": true,
              "network": false,
              "ports": false,
              "module_conf": {},
              "module_name": "fish",
              "module_version": "1.1.3",
              "pmx_version": "0.6.2",
              "error": true
          },
          "axm_dynamic": {},
          "created_at": 1472561000966,
          "pm_id": 3,
          "restart_time": 1,
          "unstable_restarts": 0,
          "_pm2_version": "1.1.3",
          "versioning": {
              "type": "git",
              "update_time": "2016-09-02T07:25:14.113Z",
              "comment": "v3.6.12 - fix-importer",
              "unstaged": false,
              "branch": "HEAD",
              "remotes": [
                  "origin"
              ],
              "remote": "origin",
              "branch_exists_on_remote": true,
              "ahead": false,
              "next_rev": null
          },
          "node_version": "6.3.0",
          "exit_code": 0
      },
      "pm_id": 3,
      "monit": {
          "memory": 90591232,
          "cpu": 0
      }
  }
]

其中每一列数据都有 rows[i].monit.cpu,值范围 0~100。可以用later写定时脚本监控并重启。

示例代码:

import { exec } from 'child_process';
import numeral from 'numeral';

exec('pm2 jlist', (err, stdout, stderr) => {
  if (stderr) {
    console.log(stderr);
  }
  const result = stdout.split('\n');

  // 如果不存在 PM2 进程,将会打初始化日志
  while (result[0].indexOf('[PM2]') === 0) {
    result.shift();
  }
  let items = [];
  try {
    items = JSON.parse(result[0]);
  } catch (e) { /* eslint no-empty:0 */ }
  // console.log(items);

  // 演示
  const item = items[0];

  const uptimeTmp = numeral((new Date() - item.pm2_env.pm_uptime) / 1000).format('00:00:00').split(':').map(Number);
  const uptime = `${parseInt(uptimeTmp[0] / 24, 10)}天${uptimeTmp[0] % 24}时${uptimeTmp[1]}分${uptimeTmp[2]}秒`.replace('0天', '').replace('0时', '').replace('0分', '').replace('0秒', '');

  console.log(item.pid);
  // 41965
  console.log(item.name);
  // app-name
  console.log(item.pm_id);
  // 0
  console.log(`${item.monit.cpu}%`);
  // 91%
  console.log(numeral(item.monit.memory).format('0.0b'));
  // 126.8MB
  console.log(uptime);
  // 6秒
  console.log(item.pm2_env.restart_time);
  // 0
  if (item.monit.cpu > 90) {
    exec(`pm2 restart ${item.pm_id}`, (err2, stdout2, stderr2) => {
      console.log(stdout2);
      console.log(stderr2);
    });
  }
});