pm2使用小结|博客系列

# 一、PM2的主要特性

内建负载均衡（使用Node cluster 集群模块）
后台运行
0秒停机重载，我理解大概意思是维护升级的时候不需要停机
具有Ubuntu和CentOS 的启动脚本
停止不稳定的进程（避免无限循环）
控制台检测
提供 HTTP API
远程控制和实时的接口API ( Nodejs 模块,允许和PM2进程管理器交互 )

# 二、基本用法

$ npm install -g pm2 命令行全局安装pm2
$ pm2 start app.js 启动app项目
$ pm2 list 列出由pm2管理的所有进程信息，还会显示一个进程会被启动多少次，因为没处理的异常

pm2 describe id 查看启动程序的详细信息

$ pm2 monit 监视每个node进程的CPU和内存的使用情况

$ pm2 logs 显示所有进程日志

强大API： pm2 web

你想要监控所有被PM2管理的进程,而且同时还想监控运行这些进程的机器的状态

启动程序的时候顺便在浏览器访问：http://localhost:9615。部署的服务器的信息和程序的信息都显示出来了

常用命令总结

$ pm2 stop all 停止所有进程
$ pm2 restart all 重启所有进程
$ pm2 reload all 0秒停机重载进程 (用于 NETWORKED 进程)
$ pm2 stop 停止指定的进程
$ pm2 restart 重启指定的进程
$ pm2 startup 产生 init 脚本保持进程活着
$ pm2 delete 杀死指定的进程
$ 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启动并生成一个配置文件

推荐使用pm2 start npm --watch --name <taskname> -- run start

# 三、配置pm2启动文件

部署参考 http://blog.poetries.top/2018/11/18/react-ssr-next-deploy/

在项目根目录添加一个processes.json：内容如下

// apps:json结构，apps是一个数组，每一个数组成员就是对应一个pm2中运行的应用
{
  "apps": [
    {
      "name": "goods",// 启动任务名
      "cwd": "/srv/node-app/current",// 应用程序所在的目录
      "script": "server.js", // 启动入口(应用程序的脚本路径)
      "log_date_format": "YYYY-MM-DD HH:mm Z", //日志格式化和monent一致
      "error_file": "/var/log/node-app/node-app.stderr.log",//自定义应用程序的错误日志文件
      "out_file": "log/node-app.stdout.log", // 日志输出路径 
      "pid_file": "pids/node-geo-api.pid",//自定义应用程序的pid文件
      "instances": 6, 
      //最小运行时间，这里设置的是60s即如果应用程序在60s内退出，pm2会认为程序异常退出，此时触发重启max_restarts设置数量
      "min_uptime": "200s",
      //设置应用程序异常退出重启的次数，默认15次（从0开始计数）
      "max_restarts": 10,
      "max_memory_restart": "1M",
      // 定时启动，解决重启能解决的问题
      "cron_restart": "1 0 * * *",
      // 是否启用监控模式，默认是false。如果设置成true，当应用程序变动时，pm2会自动重载。这里也可以设置你要监控的文件
      "watch": false,
      "merge_logs": true, // 合并多个任务日志
      // 应用程序的脚本类型，这里使用的shell，默认是nodejs
      "exec_interpreter": "node",
      // 应用程序启动模式，这里设置的是cluster_mode（集群），默认是fork
      "exec_mode": "fork",
      // 启用/禁用应用程序崩溃或退出时自动重启
      "autorestart": false,
      // 启用/禁用vizion特性(版本控制)
      "vizion": false
    }
  ]
}

可以通过pm2 start processes.json来启动。也可以把命令写在package.json里

npm run pm2

"scripts": {
  "pm2":"pm2 start processes.json"
}

# 四、Pm2部署

在项目根目录添加pm2的部署脚本文件 ecosystem.json

{
  "apps": [
      {
        "name": "goodsapp", //pm2运行的应用名称
        "script": "server.js",//服务启动入口
        "env":{
            "COMON_VARIABLE": "true"
        },
        "env_production": {
            "NODE_ENV": "production", //env
            "HOST": "localhost"
        }
      }
  ],
  "deploy": {
      // 应用名称，可以自定义，最后这样使用 pm2 deploy ecosystem.json goodsapp
      "goodsapp": {
          "user": "user_00",// 服务器用户名
          "host": ['192.68.1.201'],//服务器ip地址 可写多个
          "port": "9999",//服务器端口
          "ref": "origin/master",//从指定分支拉取代码
          "repo": "http://p.yesdat.com/diffusion/49/goodsh.git",
          "path": "/data/poetry/testDir/prev-goods.yesdat.com", //上传本地目录到服务器
          "ssh_options": "StrictHostKeyChecking=no",
          "post-deploy": "npm install --registry=https://registry.npm.taobao.org && npm install && pm2 startOrRestart ecosystem.json --env production",//部署脚本
          "env": {
              "NODE_ENV": "production"
          }
      }
  }
}

启动

pm2 deploy ecosystem.json goodsapp setup 初始化
pm2 deploy ecosystem.json goodsapp 部署

# 参考

PM2官方文档

阅读全文

← node基础篇回顾 pm2用法之ecosystem部署nodejs项目 →