擁抱 pm2 ，爲你的 nodejs 應用助力

概述

• pm2 與 supervisor 對比
• pm2 基礎用法
• 進程清單
• Logs 日誌
• 操做
• Misc
• 配置文件
• 配置文件操做命令
• 集成 Docker
• 在線監控

pm2 與 supervisor 小對比

據我所知： supervisor 能夠實現修改命令後重啓應用，可是關閉控制檯以後，整個進程就掛了。 pm2 則能夠後臺運行，關閉控制檯以後也不影響進程運行，並且有以下衆多功能，且聽我娓娓道來。

pm2 基礎用法

首先是 pm2 的安裝

npm install pm2 -g
複製代碼

啓動應用：

pm2 start app.js --name myapp
複製代碼

中止應用：

pm2 stop myapp
複製代碼

查看當前啓動應用：

pm2 list
複製代碼

查看當前全部啓動應用的 log：

pm2 logs
複製代碼

查看某一應用的 log ：

pm2 logs <app_name|app_id>  --> 例：pm2 logs myapp
複製代碼

基礎用法 plus

如下是 pm2 安裝好後的數據目錄

$HOME/.pm2 -->  will contain all PM2 related files
$HOME/.pm2/logs -->  will contain all applications logs
$HOME/.pm2/pids -->  will contain all applications pids
$HOME/.pm2/pm2.log -->  PM2 logs
$HOME/.pm2/pm2.pid -->  PM2 pid
$HOME/.pm2/rpc.sock -->  Socket file for remote commands
$HOME/.pm2/pub.sock -->  Socket file for publishable events
$HOME/.pm2/conf.js -->  PM2 Configuration
複製代碼

咱們的 log 數據會持久化到 $HOME/.pm2/logs 目錄下，如須要查找相關 log 則找到相應的 log 文件便可。

命名應用：

pm2 start app.js --name myapp
複製代碼

文件修改後，自動重啓

pm2 start app.js --watch --name myapp
複製代碼

注意： 若是使用了 --watch 參數，

pm2 stop myapp --> 將不會中止監控
pm2 stop --watch myapp --> 將會中止監控
複製代碼

設置日誌時間：（其中 Z 爲時區）

pm2 start app.js --log-date-format="YYYY-MM-DD HH:mm Z"
複製代碼

傳參給 node v8：

pm2 start app.js --node-args="--debug=7001" 
複製代碼

內存超過上限自動重啓：

pm2 start app.js --max-memory-restart 1024M
複製代碼

以當前可用 cpu 數量來開啓 node 進程數量

pm2 start app.js -i 0        
pm2 start app.js -i max     
複製代碼

進程清單

pm2 list               # 展現進程狀態
pm2 jlist              # 以原生 json 數據打印進程清單
pm2 prettylist         # 以格式化 json 數據打印進程清單
pm2 describe 0         # Display all informations about a specific process
pm2 monit              # 監控全部進程

複製代碼

Logs 日誌

pm2 logs [--raw]       # 以流的方式顯示全部日誌
pm2 flush              # 清空全部 log 文件
pm2 reloadLogs         # 重載全部 log
複製代碼

操做

pm2 stop all           # 中止全部進程
pm2 restart all        # 重啓全部進程

pm2 reload all         # Will 0s downtime reload (for NETWORKED apps)

pm2 stop 0             # 經過進程 ID 來中止某個應用
pm2 restart 0          # 經過進程 ID 來重啓某個應用

pm2 delete 0           # 經過進程 ID 來刪除某個應用
pm2 delete all         # 刪除全部應用
複製代碼

Misc

pm2 reset <process>    # Reset meta data (restarted time...)
pm2 updatePM2          # Update in memory pm2
pm2 ping               # Ensure pm2 daemon has been launched
pm2 sendSignal SIGUSR2 my-app # Send system signal to script
pm2 start app.js --no-daemon
pm2 start app.js --no-vizion
pm2 start app.js --no-autorestart
複製代碼

配置文件

配置文件有 json 和 .yml 文件兩種格式。配置文件其實跟普通命令同樣，只是將命令寫進文件當中，咱們能夠將參數，環境變量，logs file 寫進文件當中。而配置文件對微服務有很好的支持。 json 文件格式：（文件名須要以 .config.js 結尾）

module.exports = {
  apps : [{
    name        : "worker",
    script      : "./worker.js",
    output: './work/logs/out.log',//指定輸出 console.log 的位置
    error: './work/logs/error.log',//指定輸出 console.error 的位置
    log: './work/logs/combined.outerr.log',
    log_date_format: "YYYY-MM-DD HH:mm Z",
    watch       : true,
    env: {
      "NODE_ENV": "development",
    },
    env_production : {
       "NODE_ENV": "production"
    }
  },{
    name       : "api-app",
    script     : "./api.js",
    instances  : 4,
    exec_mode  : "cluster"
  }]
}
複製代碼

.yml 文件格式：

apps:
  - script   : ./api.js
    name     : 'api-app'
    instances: 4
    exec_mode: cluster
  - script : ./worker.js
    name   : 'worker'
    watch  : true
    env    :
      NODE_ENV: development
    env_production:
      NODE_ENV: production
複製代碼

配置文件操做命令

配置文件修改以後，須要 pm2 delete app 以後，再從新啓動，修改的配置才能生效

# 開啓配置文件內的全部應用
pm2 start ecosystem.config.js

# 開啓配置文件內的全部應用,並配置環境變量 production
pm2 start ecosystem.config.js --env production

# 只啓動應用名爲：myapp 的應用
pm2 start ecosystem.config.js --only api-app

# 中止配置文件內的全部應用
pm2 stop ecosystem.config.js

# 重啓配置文件內的全部應用
pm2 start   ecosystem.config.js
## 或者
pm2 restart ecosystem.config.js

# 重載配置文件內的全部應用
pm2 reload ecosystem.config.js

# 刪除配置文件內的全部應用
pm2 delete ecosystem.config.js

# 如下命令對配置文件內的單一應用生效
pm2 start   ecosystem.config.js --only api-app
pm2 restart ecosystem.config.js --only api-app
pm2 reload  ecosystem.config.js --only api-app
pm2 delete  ecosystem.config.js --only api-app
複製代碼

集成 Docker

在 Dockerfile 中運行以下命令，安裝 pm2

RUN npm install pm2 -g
複製代碼

---

CMD ["node", "app.js"]
複製代碼

用下面這行命令替代上面這條命令：

CMD ["pm2-runtime", "app.js"]
複製代碼

在線監控

官網：keymetrics 操做界面以下，看文檔操做入門很簡單，這裏我就再也不贅述了。