本文原发布于简书(2021.06.15 14:17)
公司服务器把Jenkins安装在了Windows上,很多构建都需要使用dos命令,十分难受,写这篇文章记录一下遇到的坑。
后端服务器
原本是想部署之后运行即可,结果还要备份。上网查了一下,有用 ThinBackup 插件进行备份的,还有自己创个目录备份的……五花八门。于是我先选择了自己创个目录备份的方案,设想是这样的:
- 定时对代码进行检测,当代码出现变化时,将代码从SVN上拉取下来
- 将代码通过maven打包
- 将打包好的jar使用javaw运行
结果说怎么可以是手动回退呢,让我改。再加上第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:jenkinsjenkins_homejobs%JOB_NAME%builds%Version%archivetargetxxx.jar (
del /q D:jenkinsjenkins_homeworkspace%JOB_NAME%targetxxx.jar
echo 正在复制文件
copy D:jenkinsjenkins_homejobs%JOB_NAME%builds%Version%archivetargetxxx.jar D:jenkinsjenkins_homeworkspace%JOB_NAME%targetxxx.jar
echo 正在回滚至#%Version%版本
goto start
) else (
echo 版本不存在或有误!
goto start
)
)
echo 版本%BUILD_DISPLAY_NAME%正在通过Maven打包
D:softapache-maven-3.3.9binmvn.cmd clean package -Dmaven.test.skip=true && exit %ERRORLEVEL%
:start
这里使用到了 Jenkins的环境变量 。备份文件的路径和配置详见第5步。
-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:jenkinsjenkins_homeworkspace%JOB_NAME%targetxxx.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:jenkinsjenkins_homeworkspace%JOB_NAME%targetxxx.jar D:jenkinsjenkins_homejobs%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即可看到项目
- 将
nginx/html
中的文件删除 - 将备份的
dist
文件夹拷贝到nginx/html
中
在前端部署之前,需要通过nginx反向代理将后端端口挂载到80端口的路径上,这里就不详说了。特别坑的地方是,反向代理有时候不能生效,是因为反复打开关闭nginx过程中产生了好几个nginx进程,把它们全部关闭再重新打开,反向代理就能够生效了。