nodejs pm2配置使用教程

標籤：list   技術   .sh   程式啟動   event   time   script   nbsp   添加   

pm2是非常優秀工具,它提供對基於node.js的項目運行託管服務。它基於命令列介面,提供很多特性: 內建的負載平衡器等等，下面我們就一起來看看吧。

 

一、簡介

pm2是一個帶有負載平衡功能的應用進程管理器，類似有Supervisor，forever。

二、安裝

Linux Binaries：https://nodejs.org/dist
cd oneinstack/src
wget https://nodejs.org/dist/v4.2.4/node-v4.2.4-linux-x64.tar.gz
tar xzf node-v4.2.4-linux-x64.tar.gz
cp node-v4.2.4-linux-x64/bin/node /usr/local/bin/
cp -R node-v4.2.4-linux-x64/lib/node_modules /usr/local/lib/
ln -s /usr/local/lib/node_modules/npm/bin/npm-cli.js /usr/local/bin/npm
npm install [email protected] -g #安裝最新版本pm2模組
PS: 如果你的主機無法串連公網，先找到能連公網的主機安裝上面的方法安裝pm2，然後拷貝到你要安裝的主機。拷貝如下目錄：
/usr/local/bin/node
/usr/local/lib/node_modules
再建立相關軟串連

三、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 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 [email protected] -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

啟動程式：pm2 start <app_name|id|all>列舉進程：pm2 list退出程式：pm2 stop <app_name|id|all>重起應用：pm2 restart程式資訊：pm2 describe id|all監控：pm2 monit即時集中log處理: pm2 logsAPI:pm2 web (連接埠：9615 )

nodejs pm2配置使用教程