nodejs实践录：pm2使用

本文介绍pm2的基本使用方法。主要针对pm2的命令，有关配置文件ecosystem.config.js的细节，后文将进行讲解。

重要教训

在生产环境中，谨慎使用pm2 kill、pm2 restart all这样全局性的操作。
笔者就误操作过一次，将生产服务器上所有pm2实例都干掉，还好有同事帮助，在短时间内恢复了，甲方公司那边没感知。

生成ecosystem.config.js文件

在工程目录输入：

pm2 ecosystem

启动

pm2 start(有ecosystem.config.js情况下)
pm2 start app.js（指定某个js文件）

停止

pm2 stop <PID>

注：stop只是停止了，但不是真正的删除。使用kill，才是真正的“删除”。

删除所有pm2管理的实例：

pm2 kill

pm2的管理是全局的，不管在哪个目录，执行kill操作都会删除所有的实例！，在生产环境中务必谨慎！
注：目前笔者还没有找到能“删除”某一个实例的命令。

重启

pm2 startOrGracefulReload ecosystem.config.js

pm2 startOrRestart ecosystem.config.js

pm2 reload ecosystem.config.js
pm2 reload all // 重载所有进程
pm2 reload foobar // 只重载foobar实例

pm2 restart ecosystem.config.js
pm2 restart all

上面的方式，不管是startOrGracefulReload、restart还是reload，是不会更新环境变量的，就是说，即便修改了ecosystem.config.js文件，也没有效果。pm2提供了--update-env选项，可达到目的。

更新ecosystem.config.js文件的环境变量：

pm2 reload ecosystem.config.js --update-env

注意，restart会重新启动进程，如果是socket服务，会提示端口被占用。 ——未经多次验证。

常用用法

启动时，使用生产环境：

pm2 start --env production

重启时，使用生产环境：

pm2 restart --env production

pm2自动运行

如果想让机器重启后，pm2能自动启动，则以root权限执行：

pm2 startup [平台名称]
示例：
pm2 startup
或
pm2 startup ubuntu

即可。平台名称支持的有：

ubuntu, centos, redhat, gentoo, systemd, darwin, amazon.

实际测试时发现，不输出平台名称，则pm2会自己去搜索并确定使用哪一个平台。

如果要取消开机自动运行，执行：

pm2 unstartup
或
pm2 unstartup ubuntu

要保存pm2已经管理的实例，执行：

pm2 save

注：没看到了取消保存的命令，测试发现，取消开机自动运行pm2，就会自动删除保存的实例。

下面给出一些日志信息。　　
开机自动运行：

pm2 startup
[sudo] password for latelee:
[PM2] Init System found: systemd
Platform systemd
Template
[Unit]
Description=PM2 process manager
Documentation=https://pm2.keymetrics.io/
After=network.target[Service]
Type=forking
User=root
LimitNOFILE=infinity
LimitNPROC=infinity
LimitCORE=infinity
Environment=PATH=/usr/local/bin:/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin
Environment=PM2_HOME=/home/latelee/.pm2
PIDFile=/home/latelee/.pm2/pm2.pidExecStart=/usr/local/lib/node_modules/pm2/bin/pm2 resurrect
ExecReload=/usr/local/lib/node_modules/pm2/bin/pm2 reload all
ExecStop=/usr/local/lib/node_modules/pm2/bin/pm2 kill[Install]
WantedBy=multi-user.targetTarget path
/etc/systemd/system/pm2-root.service
Command list
[ 'systemctl enable pm2-root' ]
[PM2] Writing init configuration in /etc/systemd/system/pm2-root.service
[PM2] Making script booting at startup...
[PM2] [-] Executing: systemctl enable pm2-root...
Created symlink from /etc/systemd/system/multi-user.target.wants/pm2-root.service to /etc/systemd/system/pm2-root.service.
[PM2] [v] Command successfully executed.
+---------------------------------------+
[PM2] Freeze a process list on reboot via:
$ pm2 save[PM2] Remove init script via:
$ pm2 unstartup systemd

保存实例：

# pm2 save
[PM2] Saving current process list...
[PM2] Successfully saved in /home/latelee/.pm2/dump.pm2

取消开机自动运行：

pm2 unstartup
[PM2] Init System found: systemd
Removed symlink /etc/systemd/system/multi-user.target.wants/pm2-root.service.Removed symlink /etc/systemd/system/multi-user.target.wants/pm2-root.service.[PM2] Init file disabled.

出错及处理：

$ pm2 list
[PM2][ERROR] Permission denied, to give access to current user:
$ sudo chown latelee:latelee /home/latelee/.pm2/rpc.sock /home/latelee/.pm2/pub.sock

执行sudo chown latelee:latelee /home/latelee/.pm2/rpc.sock /home/latelee/.pm2/pub.sock即可。原因应该是系统自动执行时，会以root执行，权限就变化了。

集群模式

调整实例数量：

pm2 scale <实例名称> <数量>
pm2 scale app 4

参考资料

http://www.augustkleimo.com/how-to-run-nodejs-using-pm2-on-amazon-ec2-linux/
http://pm2.keymetrics.io/docs/usage/application-declaration/

李迟 2019.2.5 周二