PM2的主要特性:
- 內建負載均衡(使用Node cluster 集羣模塊)
- 後臺運行
- 0秒停機重載,我理解大概意思是維護升級的時候不需要停機.
- 具有Ubuntu和CentOS 的啓動腳本
- 停止不穩定的進程(避免無限循環)
- 控制檯檢測
- 提供 HTTP API
- 遠程控制和實時的接口API ( Nodejs 模塊,允許和PM2進程管理器交互 )
使用它要先安裝它,用root賬號和全局模式安裝一下:
npm install -g pm2
用它來啓動程序(在當前目錄下可以直接啓動,pm2 start app.js --name uops)
[zhoujie@ops-dev uops]$ pm2 start app.js
[PM2] Spawning PM2 daemon
[PM2] Success
[PM2] Process app.js launched
┌──────────┬────┬──────┬─────┬────────┬───────────┬────────┬─────────────┬──────────┐
│ App name │ id │ mode │ PID │ status │ restarted │ uptime │ memory │ watching │
├──────────┼────┼──────┼─────┼────────┼───────────┼────────┼─────────────┼──────────┤
│ app │ 0 │ fork │ 308 │ online │ 0 │ 0s │ 21.879 MB │ disabled │
└──────────┴────┴──────┴─────┴────────┴───────────┴────────┴─────────────┴──────────┘
Use `pm2 info <id|name>` to get more details about an app
看,它顯示了Success,程序已經默默的成功的啓動了,可以實時監控程序的運行,比如執行個pm2 restart,則上述restarted那欄變成1,可以顯示程序運行了多長時間、佔用內存大小,實在是太贊啦!
終止程序也很簡單:pm2 stop
列舉出所有用pm2啓動的程序:pm2 list
[zhoujie@ops-dev uops]$ pm2 list
┌──────────┬────┬──────┬─────┬────────┬───────────┬────────┬─────────────┬──────────┐
│ App name │ id │ mode │ PID │ status │ restarted │ uptime │ memory │ watching │
├──────────┼────┼──────┼─────┼────────┼───────────┼────────┼─────────────┼──────────┤
│ app │ 0 │ fork │ 984 │ online │ 1 │ 3s │ 64.141 MB │ disabled │
└──────────┴────┴──────┴─────┴────────┴───────────┴────────┴─────────────┴──────────┘
Use `pm2 info <id|name>` to get more details about an app
查看啓動程序的詳細信息:pm2 describe id
[zhoujie@ops-dev uops]$ pm2 desc 0
Describing process with pid 0 - name app
┌───────────────────┬─────────────────────────────────────────┐
│ status │ online │
│ name │ app │
│ id │ 0 │
│ path │ /home/zhoujie/uops/app.js │
│ args │ │
│ exec cwd │ /home/zhoujie/uops │
│ error log path │ /home/zhoujie/.pm2/logs/app-error-0.log │
│ out log path │ /home/zhoujie/.pm2/logs/app-out-0.log │
│ pid path │ /home/zhoujie/.pm2/pids/app-0.pid │
│ mode │ fork_mode │
│ node v8 arguments │ │
│ watch & reload │ ✘ │
│ interpreter │ node │
│ restarts │ 1 │
│ unstable restarts │ 0 │
│ uptime │ 93s │
│ created at │ 2015-01-07T09:41:25.672Z │
└───────────────────┴─────────────────────────────────────────┘
[zhoujie@ops-dev uops]$
通過pm2 list命令來觀察所有運行的進程以及它們的狀態已經足夠好了.但是怎麼來追蹤它們的資源消耗呢?別擔心,用這個命令:pm2 monit
可以得到進程(以及集羣)的CPU的使用率和內存佔用(ctrl +c 退出)
實時集中log處理:pm2 logs
強大API: pm2 web
你想要監控所有被PM2管理的進程,而且同時還想監控運行這些進程的機器的狀態,
[zhoujie@ops-dev uops]$ pm2 web
Launching web interface on port 9615
[PM2] Process /usr/local/node/lib/node_modules/pm2/lib/HttpInterface.js launched
[PM2] Process launched
┌────────────────────┬────┬──────┬──────┬────────┬───────────┬────────┬─────────────┬──────────┐
│ App name │ id │ mode │ PID │ status │ restarted │ uptime │ memory │ watching │
├────────────────────┼────┼──────┼──────┼────────┼───────────┼────────┼─────────────┼──────────┤
│ app │ 0 │ fork │ 984 │ online │ 1 │ 9m │ 74.762 MB │ disabled │
│ pm2-http-interface │ 1 │ fork │ 1878 │ online │ 0 │ 0s │ 15.070 MB │ disabled │
└────────────────────┴────┴──────┴──────┴────────┴───────────┴────────┴─────────────┴──────────┘
Use `pm2 info <id|name>` to get more details about an app
啓動程序的時候順便在瀏覽器訪問:http://localhost:9615
擦,我眼睛被亮瞎了,這麼炫酷,竟然把部署的服務器的信息和程序的信息都顯示出來了:
這東西對程序運行的監控頁面的開發實在是太有幫助了,呵呵~~
監控:pm2 monit
實時集中log處理: pm2 logs
API:pm2 web (端口:9615 )
常用命令總結:
$ 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 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啓動文件
在項目根目錄添加一個processes.json:
內容如下:
{
"apps": [
{
"name": "mywork",
"cwd": "/srv/node-app/current",
"script": "bin/www",
"log_date_format": "YYYY-MM-DD HH:mm Z",
"error_file": "/var/log/node-app/node-app.stderr.log",
"out_file": "log/node-app.stdout.log",
"pid_file": "pids/node-geo-api.pid",
"instances": 6,
"min_uptime": "200s",
"max_restarts": 10,
"max_memory_restart": "1M",
"cron_restart": "1 0 * * *",
"watch": false,
"merge_logs": true,
"exec_interpreter": "node",
"exec_mode": "fork",
"autorestart": false,
"vizion": false
}
]
}
說明:
- apps:json結構,apps是一個數組,每一個數組成員就是對應一個pm2中運行的應用
- name:應用程序名稱
- cwd:應用程序所在的目錄
- script:應用程序的腳本路徑
- log_date_format:
- error_file:自定義應用程序的錯誤日誌文件
- out_file:自定義應用程序日誌文件
- pid_file:自定義應用程序的pid文件
- instances:
- min_uptime:最小運行時間,這裏設置的是60s即如果應用程序在60s內退出,pm2會認爲程序異常退出,此時觸發重啓max_restarts設置數量
- max_restarts:設置應用程序異常退出重啓的次數,默認15次(從0開始計數)
- cron_restart:定時啓動,解決重啓能解決的問題
- watch:是否啓用監控模式,默認是false。如果設置成true,當應用程序變動時,pm2會自動重載。這裏也可以設置你要監控的文件。
- merge_logs:
- exec_interpreter:應用程序的腳本類型,這裏使用的shell,默認是nodejs
- exec_mode:應用程序啓動模式,這裏設置的是cluster_mode(集羣),默認是fork
- autorestart:啓用/禁用應用程序崩潰或退出時自動重啓
- vizion:啓用/禁用vizion特性(版本控制)
可以通過pm2 start processes.json
來啓動。
也可以把命令寫在package.json裏。如下:
"scripts": {
"dev": "NODE_ENV=development nodemon src/server.js & NODE_ENV=development nodemon src/server/action-server.js & tools/redis/socket.js",
"dev_read_redis": "NODE_ENV=development nodemon src/app.js",
"start": "NODE_ENV=production nodemon src/app.js",
"test": "echo \"Error: no test specified\" && exit 1"
},
通過npm run start
來啓動。
關於pm2遠程部署到多臺機器,參考:
http://pm2.keymetrics.io/docs/usage/deployment/
官網:
http://pm2.keymetrics.io/docs/usage/quick-start/#42-starts