Jenkins 远程启动nodejs失败,使用pm2守护Nodejs

一、概述

使用Jenkins 远程ssh到linux，使用命令：

ssh root@192.168.10.1 'cd /data/test;nohup npm start &'

发现linux服务器的node进程没有启动。但是本地执行命令：

cd /data/test;nohup npm start &

是可以启动的。

具体原因，参考链接：

https://www.cnblogs.com/zhenbianshu/p/7152327.html

大致意思是，如果远程执行的命令，不是守护进程。即使加了nohup，关闭ssh连接后，当前用户启动的进程会全部终止。

因此，远程执行的命令，必须是守护进程才行。

二、pm2守护Nodejs

简介

pm2是nodejs的一个带有负载均衡功能的应用进程管理器的模块，类似有Supervisor，forever，用来进行进程管理。

安装

npm install pm2 -g

启动

pm2 start app.js
pm2 start app.js --name my-api #my-api为PM2进程名称
pm2 start app.js -i  #根据CPU核数启动进程个数
pm2 start app.js --watch #实时监控app.js的方式启动，当app.js文件有变动时，pm2会自动reload

查看进程

pm2 list
pm2 show  或者 # pm2 info  #查看进程详细信息，0为PM2进程id

停止

pm2 stop all #停止PM2列表中所有的进程
pm2 stop  #停止PM2列表中进程为0的进程

更多pm2命令，请参考链接：
https://www.jianshu.com/p/eb98e639f41e

三、pm2启动脚本

由于公司的Nodejs项目，比如test，它有4个服务，因此有4个app.js。

在package.json里面，有定义启动命令。比如：

"start:client": "cd ./client && npm start",

由于package.json里面有定义一些关联启动命令，因此直接用pm2启动4个app.js，会导致应用异常。

json格式

pm2 start npm -- start这条命令是pm2的万能命令，pm2 start ，就是这一系列命令中的最豪华命令。这个json我们可以理解为一个任务参数描述文件。通过这个json文件，我们把在命令行里面不好描述的各种参数放到一个json文件里面来

pm2 start <json>.json

pm2 start命令中的json格式详解

最精简版本

{
    "name": "manage",      //项目名称
    "script": "./bin/www", //要执行的脚本
    "cwd":"./",            //项目所在目录
}

执行shell文件版本

{
    "name": "manage",      //项目名称
    "script": "./bin/www.sh", //要执行的脚本
    "cwd":"./",            //项目所在目录
    "exec_interpreter": "bash",
}

实战例子demo

下面的test.json是公司项目

{
  "apps": [{
    "name": "test",  //项目名称
    "script": "test.sh",  //要执行的脚本
    "cwd": "/opt/script/",  //脚本所在目录
    "exec_interpreter": "bash",   //应用程序的脚本类型
    "exec_mode": "fork",
    "max_memory_restart": "1G",
    "autorestart": true,
    "node_args": [],
    "args": [],
    "env": {

    }
  }]
}

说明：

• 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特性(版本控制)

test.sh

#!/bin/bash

PROJECT_HOME=/data/test

source /etc/profile && cd $PROJECT_HOME;nohup /usr/bin/npm start &

当然，pm2的参数还有很多很多很多，这里仅仅是个范例demo，更多的参数可以点击这里，查看官方文档。

http://pm2.keymetrics.io/docs/usage/cluster-mode/

注意：当nodejs进程停止时，pm2会自动启动进程。

本文参考链接：

https://newsn.net/say/pm2-start-json.html