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

2023年 8月 24日 60.1k 0

本文原发布于简书(2021.06.15 14:17)

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

后端服务器

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

  • 先正常部署
    • 定时对代码进行检测,当代码出现变化时,将代码从SVN上拉取下来
    • 将代码通过maven打包
    • 将打包好的jar使用javaw运行
  • 将打包的.jar文件复制到backups文件夹
  • 需要时手动回退
  • 当文件夹中备份文件超过指定数量时,删除最旧的备份文件
  • 结果说怎么可以是手动回退呢,让我改。再加上第4点用bat实在太难写了,于是就改成用Jenkins自带的备份(或者说是将生成的文件进行保存)。自带的备份方式如下:

  • 将项目生成文件进行保存:勾选Discard old builds选项。
    勾选Discard old builds选项

  • 安装Gogs插件,选择使用参数进行构建。这里我们添加StatusVersion两个参数。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步。

  • (坑最大的一点)部署后还需要运行,但是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: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即可看到项目
  • 将打包的dist文件夹进行备份
  • 需要回退时:
    • nginx/html中的文件删除
    • 将备份的dist文件夹拷贝到nginx/html
  • 在前端部署之前,需要通过nginx反向代理将后端端口挂载到80端口的路径上,这里就不详说了。特别坑的地方是,反向代理有时候不能生效,是因为反复打开关闭nginx过程中产生了好几个nginx进程,把它们全部关闭再重新打开,反向代理就能够生效了。

    相关文章

    服务器端口转发,带你了解服务器端口转发
    服务器开放端口,服务器开放端口的步骤
    产品推荐:7月受欢迎AI容器镜像来了,有Qwen系列大模型镜像
    如何使用 WinGet 下载 Microsoft Store 应用
    百度搜索:蓝易云 – 熟悉ubuntu apt-get命令详解
    百度搜索:蓝易云 – 域名解析成功但ping不通解决方案

    发布评论