公司服务器把Jenkins安装在了Windows上,很多构建都需要使用dos命令,十分难受,写这篇文章记录一下遇到的坑。
后端服务器
原本是想部署之后运行即可,结果还要备份。上网查了一下,有用 ThinBackup 插件进行备份的,还有自己创个目录备份的……五花八门。于是我先选择了自己创个目录备份的方案,设想是这样的:
-
先正常部署定时对代码进行检测,当代码出现变化时,将代码从SVN上拉取下来将代码通过maven打包将打包好的jar使用javaw运行
将打包的.jar文件复制到backups文件夹需要时手动回退当文件夹中备份文件超过指定数量时,删除最旧的备份文件
结果说怎么可以是手动回退呢,让我改。再加上第4点用bat实在太难写了,于是就改成用Jenkins自带的备份(或者说是将生成的文件进行保存)。自带的备份方式如下:
-
将项目生成文件进行保存:勾选
Discard old builds
选项。
-
安装Gogs插件,选择使用参数进行构建。这里我们添加
Status
和Version
两个参数。Status
参数表示当前构建是deploy
(发布)还是rollback
(回滚),Version
则表示回滚到Jenkins中的哪个版本号。
写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步。
- (坑最大的一点)部署后还需要运行,但是Jenkins存在 ProcessTreeKiller 这种东东让其在执行批处理命令或Shell命令后就把期间运行的后台进程给关了,这怎么可以呢!!根据官网给出的文档,发现可以指定Jenkins启动时参数
-Dhudson.util.ProcessTree.disable=true
来禁用ProcessTree。在1.404版本开始,这个参数的名字又改成了hudson.util.ProcessTreeKiller.disable
,即-Dhudson.util.ProcessTreeKiller.disable=true
。可以在Jenkins的配置文件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
即构建的序号。
- 指定备份文件。新增构建后步骤,选择
Archive the artifacts
,将存档的文件配置好即可。备份的文件保存在%JENKINS_HOME%\jobs\%JOB_NAME%\builds\%Version%\archive\
文件夹中。
几个例子:
- dist文件夹下所有文件:
dist/
- target文件夹下所有.jar文件:
target/*.jar
- target下所有文件(不包括子文件夹):
target/*.*
- 所有.jar文件:
**/*.jar
前端部署
后端写好了前端就好办了,直接照前端办即可。我的步骤是:
- 正常部署
- 定时对代码进行检测,当代码出现变化时,将代码从SVN上拉取下来
- 将代码通过
npm
打包 - 将打包好的
dist
文件夹拷贝到nginx/html
中 - 访问IP即可看到项目
- 将打包的dist文件夹进行备份
- 需要回退时:
- 将
nginx/html
中的文件删除 - 将备份的
dist
文件夹拷贝到nginx/html
中
- 将
在前端部署之前,需要通过nginx反向代理将后端端口挂载到80端口的路径上,这里就不详说了。特别坑的地方是,反向代理有时候不能生效,是因为反复打开关闭nginx过程中产生了好几个nginx进程,把它们全部关闭再重新打开,反向代理就能够生效了。