PM2简介
PM2是常用的node进程管理工具,它可以提供node.js应用管理,如自动重载、性能监控、负载均衡等。同类工具有Supervisor、Forever等。
pm2是一个进程管理工具,可以用它来管理你的node进程,并查看node进程的状态,当然也支持性能监控,进程守护,负载均衡等功能。pm2基本是Nodejs应用程序不二的守护进程选择,事实上它并不仅仅可以启动Nodejs的程序,只要是一般的脚本的程序它同样可以胜任。
pm2的主要特性
内建负载均衡(使用node cluster集群模块,可以使用服务器上的所有cpu)
后台运行(node app.js 这种命令是直接在前台运行的,不稳定,很容易断)
0秒停机重载(应该是上线升级的时候 不需要停机)
停止不稳定的进程(避免无限循环)
控制台检测
PM2安装
使用PM2需要npm全局安装。
npm install -g pm2
启动PM2项目
直接启动项目
参数说明:
--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支持直接运行server.js启动项目,如下:
pm2 start server.js
即可启动Node.js应用,成功后会看到打印的信息:
通过配置文件管理应用
PM2还支持通过配置文件管理应用,这种方式可以提供更丰富的配置,支持的配置格式是Javascript,JSON和YAML,具体可以查看文档。
文件夹结构
PM2启动后,它将自动创建这些文件夹:
$HOME/.pm2:将包含所有PM2相关文件
$HOME/.pm2/logs:将包含所有应用程序日志
$HOME/.pm2/pids:将包含所有应用程序pids
$HOME/.pm2/pm2.log:PM2 日志
$HOME/.pm2/pm2.pid:PM2 pid
$HOME/.pm2/rpc.sock:远程命令的套接字文件
$HOME/.pm2/pub.sock:可发布事件的套接字文件
$HOME/.pm2/conf.js:PM2配置
在Windows中,$ HOME环境变量可以是$ HOMEDRIVE + $ HOMEPATH
查看当前机器上id为21的应用的详情
pm2 show app_name|app_id
或者
pm2 describe app_name|app_id
例如:
pm2 show 21
重启
pm2 restart app.js
或者
pm2 restart app_name|app_name
例如:
pm2 restart 21
停止
停止特定的应用。可以先通过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 logs来查看实时日志。这点对于线上问题排查非常重要。
比如某个node服务突然异常重启了,那么可以通过pm2提供的日志工具来查看实时日志,看是不是脚本出错之类导致的异常重启。
查看指定应用程序日志:
pm2 logs app_name|app_id
例如:
pm2 logs 21
指令tab补全
运行pm2 --help,可以看到pm2支持的子命令还是蛮多的,这个时候,自动完成的功能就很重要了。
运行如下命令。恭喜,已经能够通过tab自动补全了。细节可参考这里。
pm2 completion install
source ~/.bash_profile
负载均衡
命令如下,表示开启三个进程。如果-i 0,则会根据机器当前核数自动开启尽可能多的进程。
pm2 start app.js -i 3 # 开启三个进程
pm2 start app.js -i max # 根据机器CPU核数,开启对应数目的进程
参考文档:点击查看
开机自动启动
可以通过pm2 startup来实现开机自启动。细节可参考。大致流程如下
通过pm2 save保存当前进程状态。
通过pm2 startup [platform]生成开机自启动的命令。(记得查看控制台输出)
将步骤2生成的命令,粘贴到控制台进行,搞定。
监控CPU/内存
运行如下命令,查看当前通过pm2运行的进程的状态。即可监控CPU和内存的使用情况,同时应用的报错信息也会打印在Global Logs窗口中,如下:
pm2 monit
官方文档:http://pm2.keymetrics.io/docs/tutorials/pm2-nginx-production-setup
pm2编程接口
如果想把pm2的进程监控,跟其他自动化流程整合起来,pm2的编程接口就很有用了。细节可参考官方文档:
http://pm2.keymetrics.io/docs/usage/pm2-api/
模块扩展系统
pm2支持第三方扩展,嵌入了一个简单而强大的模块系统。
安装模块很简单:比如常用的log rotate等。可参考官方文档。
pm2 install <module_name>
保存/冻结进程
在重新启动时保存/冻结进程列表
pm2 save
监听代码变化/自动重启
可以监听代码保存,并更新应用
pm2 start app.js --watch
PM2不止监听app.js文件,还监听了它引用的所有模块,只要任意模块代码进行了保存,如键盘按下ctrl + s,或新建文件,PM2就会进行重启。 如果只想监听指定文件和目录,建议通过配置文件的watch、ignore_watch字段来设置。
如果需要忽略某些文件,则可以在配置文件中设置,如下:
{
"watch": ["server", "client"],
"ignore_watch" : ["node_modules", "client/img"],
"watch_options": {
"followSymlinks": false
}
}
watch可以是布尔值,路径数组或表示路径的字符串。默认为false。
ignore_watch可以是一个路径数组或一个字符串,它将被chokidar解释为glob或正则表达式。
watch_options是一个替代chokidar的选项的对象。有关定义,请参阅chokidar文档。
使用 pm2 进行远程自动化部署
http://shixiaoquan.win/ops/2019/10/19/remote-deploy-with-pm2.html