pm2 笔记

简介

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

安装

sudo npm install -g pm2

目录

• $HOME/.pm2 will contain all PM2 related files
• $HOME/.pm2/logs will contain all applications logs
• $HOME/.pm2/pids will contain all applications pids
• $HOME/.pm2/pm2.log PM2 logs
• $HOME/.pm2/pm2.pid PM2 pid
• $HOME/.pm2/rpc.sock Socket file for remote commands
• $HOME/.pm2/pub.sock Socket file for publishable events
• $HOME/.pm2/conf.js PM2 Configuration

常用命令

启动

pm2 start app.js --watch -i 2 --name app

参数

• --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 delete app_name|app_id
pm2 delete all

查看进程状态

pm2 list

配置文件

简单说明

• 配置文件里的设置项，跟命令行参数基本是一一对应的。
• 可以选择yaml或者json* 文件，就看个人洗好了。
• json格式的配置文件，pm2当作普通的js文件来处理，所以可以在里面添加注释或者编写代码，这对于动态调整配置很有好处。
  *如果启动的时候指定了配置文件，那么命令行参数会被忽略。（个别参数除外，比如--env）

例子

举个简单例子，完整配置说明请参考官方文档。

{
    "name": "fis-receiver",                 // 应用名称
    "script": "./bin/www",                  // 实际启动脚本
    "cwd": "./",                            // 当前工作路径
    "watch": [                              // 监控变化的目录，一旦变化，自动重启
        "bin",
        "routers"
    ],
    "ignore_watch" : [                      // 从监控目录中排除
        "node_modules",
        "logs",
        "public"
    ],
    "watch_options": {
        "followSymlinks": false
    },
    "error_file" : "./logs/app-err.log",    // 错误日志路径
    "out_file"   : "./logs/app-out.log",    // 普通日志路径
    "env": {
        "NODE_ENV": "production"            // 环境参数，当前指定为生产环境
    }
}

自动重启

pm2 start app.js --watch

重启服务

pm2 restart app.js

监控 pm2 服务

pm2 monit