pm2是非常優秀工具,它提供對基於node.js的項目運行托管服務。它基於命令行界面,提供很多特性: 內置的負載均衡器等等,下面我們就一起來看看吧。
一、簡介
pm2是一個帶有負載均衡功能的應用進程管理器,類似有Supervisor,forever。
npm install pm2@latest -g #安裝最新版本pm2模塊
三、PM2常用命令
假設你現在已經寫好了一個app.js的文件,需要啟動,你可以使用pm2進行管理
1. 啟動
# pm2 start app.js
# pm2 start app.js --name my-api #my-api為PM2進程名稱
# pm2 start app.js -i 0 #根據CPU核數啟動進程個數
# pm2 start app.js --watch #實時監控app.js的方式啟動,當app.js文件有變動時,pm2會自動reload
2. 查看進程
# pm2 list
# pm2 show 0 或者 # pm2 info 0 #查看進程詳細信息,0為PM2進程id
3. 監控
# pm2 monit
4. 停止
# pm2 stop all #停止PM2列表中所有的進程
# pm2 stop 0 #停止PM2列表中進程為0的進程
5. 重載
# pm2 reload all #重載PM2列表中所有的進程
# pm2 reload 0 #重載PM2列表中進程為0的進程
6. 重啟
# pm2 restart all #重啟PM2列表中所有的進程 ,這個會重啟所有的pm2中的進程。
# pm2 restart 0 #重啟PM2列表中進程為0的進程
7. 刪除PM2進程
# pm2 delete 0 #刪除PM2列表中進程為0的進程
# pm2 delete all #刪除PM2列表中所有的進程
8. 日志操作
# pm2 logs [--raw] #Display all processes logs in streaming
# pm2 flush #Empty all log file
# pm2 reloadLogs #Reload all logs
9. 升級PM2
# npm install pm2@lastest -g #安裝最新的PM2版本
# pm2 updatePM2 #升級pm2
10. 更多命令參數請查看幫助
# pm2 --help
四、PM2目錄結構
默認的目錄是:當前用於的家目錄下的.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
五、自定義啟動文件
創建一個test.json的示例文件,格式如下:
{
"apps":
{
"name": "test",
"cwd": "/data/wwwroot/nodejs",
"script": "./test.sh",
"exec_interpreter": "bash",
"min_uptime": "60s",
"max_restarts": 30,
"exec_mode" : "cluster_mode",
"error_file" : "./test-err.log",
"out_file": "./test-out.log",
"pid_file": "./test.pid"
"watch": false
}
}
說明:
apps:json結構,apps是一個數組,每一個數組成員就是對應一個pm2中運行的應用
name:應用程序的名稱
cwd:應用程序所在的目錄
script:應用程序的腳本路徑
exec_interpreter:應用程序的腳本類型,這里使用的shell,默認是nodejs
min_uptime:最小運行時間,這里設置的是60s即如果應用程序在60s內退出,pm2會認為程序異常退出,此時觸發重啟max_restarts設置數量
max_restarts:設置應用程序異常退出重啟的次數,默認15次(從0開始計數)
exec_mode:應用程序啟動模式,這里設置的是cluster_mode(集群),默認是fork
error_file:自定義應用程序的錯誤日志文件
out_file:自定義應用程序日志文件
pid_file:自定義應用程序的pid文件
watch:是否啟用監控模式,默認是false。如果設置成true,當應用程序變動時,pm2會自動重載。這里也可以設置你要監控的文件。
詳細參數列表:見附件八
六、實例
已上面的test.json為例
# cat > /data/wwwroot/nodejs/test.sh << EOF
#!/bin/bash
while :
do
echo "Test" >> 1.log
sleep 5
done
EOF
# chmod +x test.sh #添加執行權限
# pm2 start test.json #啟動,如下圖:
# pm2 list #查看pm2進程,如下圖:
七、備注
其他可參數見官網:http://pm2.keymetrics.io
====================================================================================================================
安裝:npm install -g pm2
module.exports = {
apps : [{
script: 'index.js',
watch: '.'
}, {
script: './service-worker/',
watch: ['./service-worker']
}],
deploy : {
production : {
user : 'SSH_USERNAME',
host : 'SSH_HOSTMACHINE',
ref : 'origin/master',
repo : 'GIT_REPOSITORY',
path : 'DESTINATION_PATH',
'pre-deploy-local': '',
'post-deploy' : 'npm install && pm2 reload ecosystem.config.js --env production',
'pre-setup': ''
}
}
};
~
$ pm2 logs # 顯示所有應用程序的日志
$ pm2 logs [app-name] # 顯示指定應用程序的日志
日志文件在 root/.pm2下面的logs文件夾。
