PM2常用命令

$ 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](http://localhost:9615/))
$ pm2 delete 0 # 杀死指定的进程
$ pm2 delete all # 杀死全部进程

运行进程的不同方式：
$ 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

PM2配置

安装pm2后，可通过pm2 init或pm2 ecosystem来生成pm2初始化配置

module.exports = {

	"apps": [{
		// 指定项目名称
		"name": "be_frontend",
		// 指定服务启动执行文件 
		"script": 'index.js',
		// 指定服务根目录
		"cwd": "./".
		// 指定传递给脚本参数
		"args": ["--enable-logs", "-n", "15"],
		// 指定脚本解释器
		"interpreter": "node", 
		// 指定是否监听文件变化重启
		"watch": true,
		// 忽略监听文件列表
		"ignore_watch": [
			"node_modules",
			"logs"],
		// 指定服务启动模式，分为cluster和fork
		"exec_mode": "fork",
		// 集群模式启动实例个数，仅集群模式有效
		"instances": 4,
		// 应用可用最大内存，超出后自动重启
		"max_memory_restart": "500M",
		// 指定日志路径
		"out_file": "/opt/wks/logs/app-out.log",
		"error_file": "/opt/wks/logs/app-error.log",
		// 指定日志为追加模式，不创建新日志文件
		"merge_logs": true,
		// 指定日志时间格式
		"log_date_format":"YYYY-MM-DD HH:mm:ss",
		// 最小运行时长，小于该时间则认为异常，自动进行重启
		"min_uptime": "60s",
		// 最大异常重启次数
		"max_restarts": 10,
		"autorestart":true,
		// 仅支持集群模式，按crontab模式定期重启服务
		"cron_restart":"",
		// 异常重启延迟时间
		"restart_delay": "60s",
		// 指定process.env环境变量参数
		"env": {
			"NODE_ENV": "production",
			"DATABASE_URL": "DBHOST"
		}
		// 启动服务指定环境变量  等价于  pm2 start app.js -- env_production
		"env_production": {
			"NODE_ENV": "prodiction"
		},
		"env_development": {
			"NODE_ENV": "development"
		}
	}],

	deploy: {
		production: {
			// 远端用户
			user: "root",
			// 远端主机地址
			host: "59.111.211.37",
			// git分支
			ref: "dsc_as/master",
			// git地址
			repo: "git@github.com:destinys/dsc_as.git",
			// 远端文件路径
			path: "/opt/wks/app",
			// 部署后动作
		  post-deploy:"npm install && pm2 reload ecosystem.config.js --env production"
		
		}
	}

}

通过配置文件启动服务： pm2 start filename.json

日志管理

pm2 进程本身日志默认存储路径为$HOME/.pm2/pm2.log
pm2默认为启动的每个服务生成两个日志文件：普通日志和错误日志，存储路径为$HOME/.pm2/logs/服务名-out.log以及$HOME/.pm2/logs/服务名-error.log

可通过配置文件变更默认存储路径：

output: '/opt/wks/logs/xxx-out.log'
error: '/opt/wks/logs/xxx-error.log'
merge_logs: true

合并日志并滚动

通过pm2-logrotate模块实现；

pm2 install pm2-logrotate

pm2 set pm2-logrotate: rotateInterval  '*  */1 *  *  *'  -- 配置日志备份间隔，类似crontab配置
pm2 set pm2-logrotate:compress true  --是否启动压缩
pm2 set pm2-logrotate: retain 3  --保存备份数量