PM2是node进程管理工具,可以利用它来简化很多node应用管理的繁琐任务,如性能监控、自动重启、负载均衡等,而且使用非常简单。
PM2的运行需要node 环境和npm的支持,node 环境和npm安装检查:
PM2常用命令:
--watch:监听应用目录的变化,一旦发生变化,自动重启。如果要精确监听、不见听的目录,最好通过配置文件。
-i --instances:启用多少个实例,可用于负载均衡。如果-i 0或者-i max,则根据当前机器核数确定实例数目。
--ignore-watch:排除监听的目录/文件,可以是特定的文件名,也可以是正则。例如,–ignore-watch=”test node_modules “some scripts”“
-n --name:应用的名称,查看应用信息的时候可以用到。
-o --output :标准输出日志文件的路径。
-e --error :错误输出日志文件的路径。
--interpreter :the interpreter pm2 should use for executing app (bash,python…)。比如你用的coffee script来编写应用。
参考官网文档
1) 全局安装
管理员cmd窗口运行: npm install pm2 -g
2) 安装windows自启动包
npm install pm2-windows-startup -g
3) 执行命令
pm2-startup install
4) 查看是否安装成功
pm2 -v
1) 官方样例使用指南
pm2 examples
2) 启动
语法: pm2 start 路径 --name 名称 --watch
pm2 start app.js //启动app.js应用
pm2 start app.js --name demo //启动应用并设置name
pm2 start app.sh //脚本启动
举例(注意命令行空格):
pm2 start D:/XLDNPSService/XLConsulInfoExportTool/XLConsulInfoExportTool.exe --name XLConsulInfoExportTool --watch
3) 查看列表
pm2 ls
4) 停止
pm2 stop all //停止所有应用
pm2 stop [名称] //根据应用名停止指定应用
pm2 stop [ID] //根据应用id停止指定应用
举例: pm2 stop XLConsulInfoExportTool
5) 重启
pm2 restart 名称 //同时杀死并重启所有进程。短时间内服务不可用。生成环境推荐使用reload
举例: pm2 restart XLConsulInfoExportTool
6) 删除进程
pm2 delete all //关闭并删除应用
pm2 delete [AppName] //根据应用名关闭并删除应用
pm2 delete [ID] //根据应用ID关闭并删除应用
举例: pm2 delete XLConsulInfoExportTool
7) 自动重启
pm2 start 路径 --name 名称 --watch
pm2 start app.js –watch
8) 日志查看
除了可以打开日志文件查看日志外,还可以通过pm2 logs来查看实时日志
pm2 logs
9) 更新
pm2 update
10) 保存
pm2 save
11) 创建开机启动
pm2 startup
补充命令:
$ npm install pm2 -g # 命令行安装 pm2
$ pm2 start app.js -i 4 # 后台运行pm2,启动4个app.js
# 也可以把'max' 参数传递给 start
# 正确的进程数目依赖于Cpu的核心数目
$ pm2 start app.js --name my-api # 命名进程
$ pm2 list # 显示所有进程状态
$ pm2 monit # 监视所有进程
$ pm2 logs # 显示所有进程日志
$ pm2 stop all # 停止所有进程
$ pm2 restart all # 重启所有进程
$ pm2 reload all # 0 秒停机重载进程 (用于 NETWORKED 进程)
$ pm2 stop 0 # 停止指定的进程
$ pm2 restart 0 # 重启指定的进程
$ pm2 startup # 产生 init 脚本 保持进程活着
$ pm2 web # 运行健壮的 computer API endpoint (http://localhost:9615)
$ pm2 delete 0 # 杀死指定的进程
$ pm2 delete all # 杀死全部进程
参考链接
1) 生成示例配置文件
pm2 ecosystem //生成一个示例JSON配置文件
pm2 init
2) 配置文件示例(实际使用自行修改)
{
"apps": {
"name": "wuwu", // 项目名
"script": "./bin/www", // 执行文件
"cwd": "./", // 根目录
"args": "", // 传递给脚本的参数
"interpreter": "", // 指定的脚本解释器
"interpreter_args": "", // 传递给解释器的参数
"watch": true, // 是否监听文件变动然后重启
"ignore_watch": [ // 不用监听的文件
"node_modules",
"logs"
],
"exec_mode": "cluster_mode", // 应用启动模式,支持fork和cluster模式
"instances": 4, // 应用启动实例个数,仅在cluster模式有效 默认为fork;或者 max
"max_memory_restart": 8, // 最大内存限制数,超出自动重启
"error_file": "./logs/app-err.log", // 错误日志文件
"out_file": "./logs/app-out.log", // 正常日志文件
"merge_logs": true, // 设置追加日志而不是新建日志
"log_date_format": "YYYY-MM-DD HH:mm:ss", // 指定日志文件的时间格式
"min_uptime": "60s", // 应用运行少于时间被认为是异常启动
"max_restarts": 30, // 最大异常重启次数,即小于min_uptime运行时间重启次数;
"autorestart": true, // 默认为true, 发生异常的情况下自动重启
"cron_restart": "", // crontab时间格式重启应用,目前只支持cluster模式;
"restart_delay": "60s" // 异常重启情况下,延时重启时间
"env": {
"NODE_ENV": "production", // 环境参数,当前指定为生产环境 process.env.NODE_ENV
"REMOTE_ADDR": "爱上大声地" // process.env.REMOTE_ADDR
},
"env_dev": {
"NODE_ENV": "development", // 环境参数,当前指定为开发环境 pm2 start app.js --env_dev
"REMOTE_ADDR": ""
},
"env_test": { // 环境参数,当前指定为测试环境 pm2 start app.js --env_test
"NODE_ENV": "test",
"REMOTE_ADDR": ""
}
}
}