Windows使用Jenkins构建前后端分离项目+项目回滚和备份

公司服务器把Jenkins安装在了Windows上，很多构建都需要使用dos命令，十分难受，写这篇文章记录一下遇到的坑。

后端服务器

原本是想部署之后运行即可，结果还要备份。上网查了一下，有用 ThinBackup 插件进行备份的，还有自己创个目录备份的……五花八门。于是我先选择了自己创个目录备份的方案，设想是这样的：

1. 先正常部署
   • 定时对代码进行检测，当代码出现变化时，将代码从SVN上拉取下来
   • 将代码通过maven打包
   • 将打包好的jar使用javaw运行
2. 将打包的.jar文件复制到backups文件夹
3. 需要时手动回退
4. 当文件夹中备份文件超过指定数量时，删除最旧的备份文件

结果说怎么可以是手动回退呢，让我改。再加上第4点用bat实在太难写了，于是就改成用Jenkins自带的备份（或者说是将生成的文件进行保存）。自带的备份方式如下：

1. 将项目生成文件进行保存：勾选Discard old builds选项。
   

   勾选Discard old builds选项

2. 安装Gogs插件，选择使用参数进行构建。这里我们添加Status和Version两个参数。Status参数表示当前构建是deploy（发布）还是rollback（回滚），Version则表示回滚到Jenkins中的哪个版本号。
   

   参数构建

3. 写bat命令，通过%Status%和%Version%来获取参数，通过判断参数确定是否进行打包，还是从备份文件中拷贝：

@echo off
if "%Status%" == "rollback" (
    echo 即将回滚到#%Version%版本
    if exist D:\jenkins\jenkins_home\jobs\%JOB_NAME%\builds\%Version%\archive\target\xxx.jar (
        del /q D:\jenkins\jenkins_home\workspace\%JOB_NAME%\target\xxx.jar
        echo 正在复制文件
        copy D:\jenkins\jenkins_home\jobs\%JOB_NAME%\builds\%Version%\archive\target\xxx.jar D:\jenkins\jenkins_home\workspace\%JOB_NAME%\target\xxx.jar
        echo 正在回滚至#%Version%版本
        goto start
    ) else (
        echo 版本不存在或有误！
        goto start
    )
)
echo 版本%BUILD_DISPLAY_NAME%正在通过Maven打包
D:\soft\apache-maven-3.3.9\bin\mvn.cmd clean package -Dmaven.test.skip=true && exit %ERRORLEVEL%
:start

这里使用到了 Jenkins的环境变量 。备份文件的路径和配置详见第5步。

4. （坑最大的一点）部署后还需要运行，但是Jenkins存在 ProcessTreeKiller 这种东东让其在执行批处理命令或Shell命令后就把期间运行的后台进程给关了，这怎么可以呢！！根据官网给出的文档，发现可以指定Jenkins启动时参数-Dhudson.util.ProcessTree.disable=true来禁用ProcessTree。在1.404版本开始，这个参数的名字又改成了hudson.util.ProcessTreeKiller.disable，即-Dhudson.util.ProcessTreeKiller.disable=true。可以在Jenkins的配置文件Jenkins.xml中添加该参数：
   
   Jenkins.xml

还有更方便的，直接更改ProcessTreeKiller正在寻找的环境变量BUILD_ID即可暂时禁用ProcessTreeKiller。官网只给出了Shell命令的写法，在运行jar之前写上

BUILD_ID=dontKillMe

BUT，我们是Windows，故应该改成

set BUILD_ID=dontKillMe
start "任务名" javaw -jar D:\jenkins\jenkins_home\workspace\%JOB_NAME%\target\xxx.jar &

之后再用Linux的nohup或者Windows的javaw命令即可后台运行jar包了。

还有一个打印日志的问题：在Linux中使用nohup命令还好办；而在Windows中，单独使用javaw命令并配合管道工具（>和>>）可以打印日志，但即使改变了BUILD_ID，Jenkins也不会关闭，会一直提示“构建中”。我们使用了start命令，但是start命令只能运行一个命令，会忽略掉后面的管道工具，从而不能打印日志。解决方案是，写一个bat命令保存在本地，并使用外部参数来作为jar包的路径和日志的路径。bat命令内容如下：

@echo off
javaw -jar %1 > %2
exit

上面的命令行则变成：

set BUILD_ID=dontKillMe
start bat路径 D:\jenkins\jenkins_home\workspace\%JOB_NAME%\target\xxx.jar D:\jenkins\jenkins_home\jobs\%JOB_NAME%\builds\%BUILD_NUMBER%\px.log &

日志就会保存在每次构建的目录中。其中的BUILD_NUMBER即构建的序号。

5. 指定备份文件。新增构建后步骤，选择Archive the artifacts，将存档的文件配置好即可。备份的文件保存在%JENKINS_HOME%\jobs\%JOB_NAME%\builds\%Version%\archive\文件夹中。
   
   构建后操作
   
   几个例子：

• dist文件夹下所有文件：dist/
• target文件夹下所有.jar文件：target/*.jar
• target下所有文件（不包括子文件夹）：target/*.*
• 所有.jar文件：**/*.jar

前端部署

后端写好了前端就好办了，直接照前端办即可。我的步骤是：

1. 正常部署
   • 定时对代码进行检测，当代码出现变化时，将代码从SVN上拉取下来
   • 将代码通过npm打包
   • 将打包好的dist文件夹拷贝到nginx/html中
   • 访问IP即可看到项目
2. 将打包的dist文件夹进行备份
3. 需要回退时：
   • 将nginx/html中的文件删除
   • 将备份的dist文件夹拷贝到nginx/html中

在前端部署之前，需要通过nginx反向代理将后端端口挂载到80端口的路径上，这里就不详说了。特别坑的地方是，反向代理有时候不能生效，是因为反复打开关闭nginx过程中产生了好几个nginx进程，把它们全部关闭再重新打开，反向代理就能够生效了。