pm2 手册

安装

1	npm install pm2@latest -g

常用命令

基本上能使用程序name的地方也可以使用id(id一般是从0开始的)

pm2 start app.js	# 直接启动某个项目
pm2 start app.js --name my-app	# 设置应用名称
pm2 start app.js --no-daemon	# 以非daemon方式运行
pm2 start app.js --max-memory_restart 20M	# 当内存超过20M时就重启应用
pm2 start npm --name my-app -- run start # npm run start方式启动
pm2 start yarn --interpreter bash --name my-app -- start	# yarn start方式启动
pm2 start myscript.sh	# 如果是可执行的，那么直接start就可以了
pm2 start myscript.py --interpreter=/usr/bin/python3	# 启动任意解释器的脚本
pm2 start xxx -o ./out.log -e ./err.log	# 这样可以改变当前进程的日志输出地址，目前没找到全局修改的地方，另外-l参数是将标准输出和错误输出都输出到目标，但是同时也会输出到之前的标准输出和错误输出
pm2 start app.js --cron-restart="0 0 * * * "	# 设置自动定时重启 

pm2 stop all	# 停止所有程序
pm2 restart all	# 重启所有程序
pm2 delete 0	# 删除某个进程
pm2 delete all	# 删除所有进程

pm2 list	# 列出所有使用pm2管理的程序
pm2 prettylist	# 用json格式输出

pm2 describe 0	# 查看程序详情，比如启动命令，日志文件位置，nodejs版本，开始时间，堆栈使用情况，延迟时间
pm2 show 0	# 同上
pm2 monit	# 实时监听所有进程，和describe的输出差不多，不过这个是实时的，而且可以看到日志
pm2 monitor appname	# 查看pm2管理的所有进城的详细状态

日志相关

默认的日志也会通过项目 package.json -> version分开设置

pm2 logs				# 查看所有应用的日志，如果要监听，最好用monitor命令，看得全一点
pm2 logs appname	# 查看指定app的日志输出
pm2 flush # 晴空日志文件

pm2 logrotate -u user	# 设置日志自动轮转，这条命令会写入一条轮转配置到/etc/logrotate.d/pm2-user，但是默认配置是保留12个日志文件，不是按照大小分的
pm2 install pm2-logrotate	# 另一种方式实现日志轮转，默认10M，安装后用pm2 list能够看到一个module，更推荐这个，安装完成后会给你设置命令的

$ pm2 set pm2-logrotate:max_size 100M	# 注意这里必须是M，而不是MB，否则不起作用，就会每分钟都轮转了
$ pm2 set pm2-logrotate:retain 30
$ pm2 set pm2-logrotate:compress false
$ pm2 set pm2-logrotate:dateFormat YYYY-MM-DD_HH-mm-ss
$ pm2 set pm2-logrotate:workerInterval 60
$ pm2 set pm2-logrotate:rotateInterval 0 0 * * *
$ pm2 set pm2-logrotate:rotateModule true
Modules configuration. Copy/Paste line to edit values.
[PM2][Module] Module successfully installed and launched
[PM2][Module] Checkout module options: `$ pm2 conf`

设置开机启动

pm2 startup [ubuntu|centos|gentoo|systemd]	# 这样可以自动生成开机启动脚本
pm2 startup ubuntu -u www	# 指定命令执行用户
pm2 save
systemctl status pm2-ubuntu	# 配置完成后可以用这个命令查看时候配置成功了，如果发现service并没有启动成功可以尝试pm2 kill，然后sudo systemctl start pm2-ubuntu.service

配置文件

可以以文件的方式设置配置，比如在项目根目录下放一个文件: pm2.config.js，运行时候只需要pm2 start pm2.config.js --env production，如果不佳env配置就不用加--env参数

module.exports = {
  apps: [
    {
      name: 'test',
      script: 'server.js',	// 相当于node server.js，如果是npm run start命令，那么script就写npm，args里面放start
      args: 'start', // npm命令参数可以放在这里
      log_date_format: 'YYYY-MM-DD HH:mm Z',
      ignoreWatch: ["[\\/\\\\]\\./", "node_modules"],
      watch: true,
      cwd: 'path/to/project'
      instances: 1,
      exec_mode: "cluster",
      env: {	 // 环境变量
        NODE_ENV: 'production',
        logging: 'on'
      },
      env_staging: {
        NODE_ENV: 'staging',
        logging: 'on'
      }
    },
  ]
}

Troubleshooting

没有错误日志无限重启: 可能原因是运行脚本有问题，例如配置的npm run dev，但是程序里面的dev脚本依赖的却是另外一个命令，但是那个命令却没有全局安装
Current process list running is not in sync with saved list. npm differs. Type ‘pm2 save’ to synchronize: 这不是什么错误，而是提醒你讲进程保存到磁盘，这样下次服务器重启能够找到有哪些进程