PM2 简介与使用

介绍：

pm2 是一个node进程管理器，并且它内置一个负载均衡。可以保证服务不会中断一直在线，并且还有其他一系列进程管理、监控功能。

特性

• 内建负载均衡（使用Node cluster 集群模块）
• 后台运行
• 0秒停机重载(维护升级的时候不需要停机).
• 停止不稳定的进程（避免无限循环）
• 控制台检测
• 提供 HTTP API
• 远程控制和实时的接口API ( Nodejs 模块,允许和PM2进程管理器交互 )

运行

pm2 start app.js --name my-api # 命名进程

其他运行方式：

pm2 start app.js -i max # 根据有效CPU数目启动最大进程数目 pm2 start app.js -i 3 # 启动3个进程 pm2 start app.js -x #用fork模式启动 app.js 而不是使用 cluster pm2 start app.js -x -- -a 23 # 用fork模式启动 app.js 并且传递参数 (-a 23) pm2 start app.js --name serverone # 启动一个进程并把它命名为 serverone pm2 stop serverone # 停止 serverone 进程 pm2 start app.json # 启动进程, 在 app.json里设置选项 pm2 start app.js -i max -- -a 23 #在--之后给 app.js 传递参数 pm2 start app.js -i max -e err.log -o out.log # 启动 并 生成一个配置文件，你也可以执行用其他语言编写的app ( fork 模式): pm2 start my-bash-script.sh -x --interpreter bash pm2 start my-python-script.py -x --interpreter python

npm 运行

pm2 start npm -- start

启动一个进程并把它命名为 test

pm2 start npm --name test -- start

使用

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 start app.js --watch #监听模式启动，当文件发生变化，自动启动 pm2 start app.js -i max # 启用集群模式（自动负载均衡） pm2-dev start ...      # 开启开发模式，即不启用后台运行 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 # 杀死全部进程 pm2 show 0             # 查看指定进程 pm2 gracefulReload all # 以群集模式重新加载所有应用程序 pm2 kill 杀掉pm2管理的所有进程;

配置

1.    命令生产默认示例配置文件pm2 ecosystem或pm2 init,运行默认会生成ecosystem.config.js配置文件

module.exports = { apps: [ { name: 'back-Api', //应用名 script: './server/start.js', //应用文件位置 env: { PM2_SERVE_PATH: "./apidoc", //静态服务路径 PM2_SERVE_PORT: 8080, //静态服务器访问端口 NODE_ENV: 'development' //启动默认模式 }, env_production : { NODE_ENV: 'production' //使用production模式 pm2 start ecosystem.config.js --env production }, instances:"max", //将应用程序分布在所有CPU核心上,可以是整数或负数 instance_var: "INSTANCE_ID", exec_mode: "cluster", watch:[ "server", ], //监听模式，不能单纯的设置为true，易导致无限重启，因为日志文件在变化，需要排除对其的监听 merge_logs: true, //集群情况下，可以合并日志 } ], deploy: { production : { user: 'node', //ssh 用户 host: '212.83.163.1', //ssh 地址 ref: 'origin/master', //GIT远程/分支 repo: '[email protected]:repo.git', //git地址 path: '/var/www/production', //服务器文件路径 "post-deploy": 'npm install && pm2 reload ecosystem.config.js --env production' //部署后的动作 } } };

pm2常用配置项解析

1. apps:json结构，apps是一个数组，每一个数组成员就是对应一个pm2中运行的应用 2. name:应用程序名称"app" 3. cwd:应用程序所在的目录"./" 4. script:应用程序的脚本路径"./" 5. log_date_format: 日志文件名输出日期格式"YYYY-MM-DD HH:mm Z" 6. error_file:自定义应用程序的错误日志文件"./logs/app-err.log", 7. out_file:自定义应用程序日志文件"./logs/app-out.log" 8. instances: 应用启动实例个数，仅在cluster模式有效 默认为fork；或者 max 9. min_uptime:最小运行时间，这里设置的是60s即如果应用程序在60s内退出，pm2会认为程序异常退出，此时触发重启max_restarts设置数量 10. max_restarts:设置应用程序异常退出重启的次数，默认15次（从0开始计数） 11. cron_restart:定时启动，解决重启能解决的问题 12. watch:是否启用监控模式，默认是false。如果设置成true，当应用程序变动时，pm2会自动重载。这里也可以设置你要监控的文件。 13. "ignore_watch": [ // 不用监听的文件 "node_modules", "logs" ], 13. merge_logs:// 设置追加日志而不是新建日志 14. exec_interpreter:应用程序的脚本类型，这里使用的shell，默认是nodejs 15. exec_mode:应用程序启动模式，这里设置的是cluster_mode（集群），默认是fork 16. autorestart:启用/禁用应用程序崩溃或退出时自动重启,默认为true, 发生异常的情况下自动重启 17. vizion:启用/禁用vizion特性(版本控制) 18. "args": "", // 传递给脚本的参数 19. env: { PM2_SERVE_PATH: "./apidoc", //静态服务路径 PM2_SERVE_PORT: 8080, //静态服务器访问端口 NODE_ENV: 'development' //启动默认模式 }, 20. env_production : { NODE_ENV: 'production' //使用production模式 pm2 start ecosystem.config.js --env production },