svn war包, 远程 tomcat

svn-remote 模式是指, tomcat 和 jenkins 安装在不同Linux服务器上, war 存放在svn服务器上, 需要通过jenkins 插件将war包下载到jenkins 所在Linux 服务器上. 这和svn-local 方式很像, 不同的是, 需要将war包上传到远程Linux 服务器上, 并在远程Linux 服务器上执行脚本.

svn-remote 模式自动化部署逻辑:

1. 通过jenkins subversion 插件下载到jenkins 所在服务器上的指定目录, 如/tmp 2 将war包移动到工作空间中, 再拷贝到tomcat的 temp 目录下
2. 通过Publish Over SSH 插件将war包上传到远程服务器, 并在远程服务器上执行重部署脚本
3. 重新部署成功之后, 在本地执行备份脚本

0. 配置远程linux服务器信息

点击 jenkins -> 系统管理 -> 系统设置, 配置 Publish over SSH

• Name: 为服务器取个别名, 笔者习惯命名为: ip@username
• HostName: 域名或ip地址
• Username: 登录用户名
• RemoteDirectory: 远程登录之后,进入的默认目录, 建议写根目录就行
• Passphrase / Password : 远程登录密码, 这个在高级选项里

1. 任务配置

新建自由风格任务时, 我们选择copy 配置, 从已有配置中copy 一份, 略加修改即可.
点击jenkins ,新建自有风格的任务, 输入任务名称, 选中自有风格项目,copy from 输入LB-svn-local, 点击OK

1.1 配置General

1.1.1 配置-项目名称

笔者认为这个应该叫任务(job)名称更合适, 因为这个名称就是创建任务时填写的名称, jenkins用于标识它的内置变量也是 JOB_NAME. 此名称一定要有一定的规则, 笔者命名为:LB-free-svn-remote

1.1.2 配置-任务描述

对任务做一下言简意赅的描述, 可以配置显示在任务列表中.

1.1.3 配置-旧的构建丢弃策略

指定旧的构建记录删除策略, 默认事不删除的, 这样会占用大量的磁盘空间, 没有太大意义. 笔者设置删除策略为: 保持构建的最大个数: 10, 也就是说最多保留10条构建记录

1.1.4 配置-参数化构建过程

• 参数化构建过程是一个比较好用的功能, 脚本中可以使用定义的参数,但是jenkins 的插件却支持的不是特别好, 使用的时候需要注意一下.
• 对于local-local 模式的人物, 笔者会创建以下几个String 类型常用变量: 点击添加参数 -> String Parameter

1.1.5 配置-JDK

当系统设置中配置了多个jdk 时, 此时需要选择jdk 版本号, 笔者选择的是 jdk 1.7

1.2 源码管理

1.2.1 输入svn 服务器的相关信息

• Repository URL 输入war包所在svn服务器父目录的svn 访问地址, 建议在svn上一个war包创建一个目录,因为下载时, 会将整个目录中的文件全部下载到本地
• Credentials: 用户身份认证信息
• Local module directory: 点代表的是$WORKSPACE 目录

1.2.2 填写用户身份信息

如果服务器svn 服务器必须登录的话,选择 Credetials, 如果无可选择的, 则点击add 新增svn 认证信息, 此处使用用户名密码认证策略.

1.3 构建

因为我们配置svn的 Local module directory 为. , 即工作空间目录, 所以不需要对war做移动处理.

1.2.3 上传war包到远程服务器, 并在远程服务器上执行重部署脚本

由于tomcat 在远程linux 服务器, 所以需要将war包上传到远程tomcat 服务器的temp 目录下, 然后让远程服务器执行重新部署tomcat 脚本, 然后监测远程tomcat 是否重新部署成功

重部署脚本逻辑：

1. 检测temp 目录中war 文件是否存在
2. 停止 tomcat 服务器
3. 删除webapps 目录中的war文件和文件夹
4. 清空服务器工作目录
5. 清空日志文件
6. 将项目war包从临时目录(temp)移动到部署目录(webapps)
7. 重新启动tomcat服务器
8. 检测服务器是否能启动成功

点击新增构建步骤-> Send files or execute commonds over SSH.

• Name: 选择要上传或执行脚本的远程Linux服务器, 这个是在系统设置中配置的
• Source files: 要上传的文件, 不支持绝对路径, 只能写相对路径, 相对目录为当前工作空间
• Remove Prefix: 如果Source files 填写的包含路径, 如target/LoadBalance.war, 那么这个地方就建议移除前缀target/
• Remote Directory: 远程Linux 服务器的文件夹, 此处为远程tomcat 的temp 目录
• Exec Command: 要执行的远程linux 脚本, 此脚本和local-local 模式基本相同, 唯一不同的就是远程服务器不需要执行: BUILD_ID=dontKillMe bash $serverBin/startup.sh
• 需要勾选高级中的: Fail the build if an error occurs, 意思是如果出现错误的话, 就停止构建.

远程重部署脚本:

#!/bin/bash
#DESC 部署项目
#PARM 参数化参数: serverHome, testUrl, timeout, $warName

#输出日志
echo "[info ] begin deploy project: $warName"

##################### 常量定义 #####################
# 应用服务器相关文件夹
serverBin=$serverHome/bin
serverLog=$serverHome/logs
serverTemp=$serverHome/temp
serverDeploy=$serverHome/webapps
serverWork=$serverHome/work/Catalina/localhost


##################### 执行脚本 #####################
# 0. 检测文件是否存在
if [ ! -f "$serverTemp/$warName.war" ]; then
  echo "[error] The file $serverTemp/$warName.war is not exsits !!!"
  exit 1
else
   echo "[info ] Find file: $serverTemp/$warName.war";

fi

# 1. 关闭服务器
echo "[info ] shutdown the server ..."
ps -ef | grep -v grep | grep "$serverHome"| awk '{print $2}' | xargs kill -9

# 2. 删除部署项目的war包和文件夹
echo "[info ] delete the old project: $serverDeploy/$warName $serverDeploy/$warName.war"
rm -rf $serverDeploy/$warName $serverDeploy/$warName.war

# 3. 清空服务器工作目录
echo "[info ] clean the project work directory: $serverWork/$warName"
rm -rf $serverWork/$warName

# 4. 清空日志文件
echo "[info ] clean the server log: $serverLog/catalina.out"
echo "" > $serverLog/catalina.out

# 5. 将新项目文件移动到服务器部署文件夹中
echo "[info ] deploy the project: $serverTemp/$warName.war"
mv $serverTemp/$warName.war $serverDeploy

# 6. 重新启动服务器
echo "[info ] start the server: $serverBin/startup.sh &"
$serverBin/startup.sh &


# 7. 监控服务器是否启动成功
echo "[info ] monitor the server start ..."
cost=0
statusCode=0
while [ $statusCode -ne 200 -a $cost -le $timeout ]
  do
    statusCode=`curl -o /dev/null -s -w %{http_code} $testUrl`
    echo "cost:$cost ms, statusCode:$statusCode"
    cost=$(( $cost + 5 ))
    sleep 5
  done

if [ $statusCode -ne 200 ] ; then
  #如果启动不成功则杀死进程
  echo "[error] the server startup faild ! begin shutdown the server "
  ps -ef | grep -v grep | grep "$serverName" | awk '{print $2}' | xargs kill -9
  exit 1
else
  #服务器启动成功
  echo "[info ] the server startup successful !"
  exit 0
fi

1.2.4 本地执行备份脚本

• 重新部署成功之后, 对新版本进行备份

构建模块中, 点击新增构建步骤 -> Execute Shell

#!/bin/bash
#DESC 部署成功后,备份项目
#PARM 参数化参数: $warName, $warDir
#PARM jk内置参数: $JOB_NAME, $BUILD_NUMBER
#PARM 全局自定义: $ITEM_BACKUP, $ITEM_BID_FILE

#输出日志
echo "[info ] begin backup project: $warName"

# 备份文件夹
bk_dir=$ITEM_BACKUP/$JOB_NAME

# 创建备份文件夹: 如果文件夹不存在则创建文件夹, 否则删除原来的文件$warName.war
if [ ! -d "$bk_dir" ]; then
  mkdir -p $bk_dir
else
  rm -f $bk_dir/$warName.war
fi

# 备份文件
mv $WORKSPACE/$warName.war $bk_dir
cp $bk_dir/$warName.war $bk_dir/$warName.war.$BUILD_NUMBER

# 记录成功的id
date_time=`date "+%Y%m%d-%H%M"`
echo "$date_time $BUILD_NUMBER $description" >> $ITEM_BACKUP/$JOB_NAME/$ITEM_BID_FILE

2. 执行jenkins 任务

1. 点击 jenkins -> LB-free-local-local -> Build with Parameters
2. 输入部署描述信息, 点击立即构建
3. 点击版本号 #1 右边的小三角, 会弹出菜单, 点击 console output, 可以查看日志输出

3. 测试:

3.1 测试

• 确定防火墙已关闭或者释放了tomcat 服务器端口7080
• 浏览器中输入测试地址:

3.2 查看备份

通过linux 远程工具登录Linux 服务器, 可以进入备份文件夹, 会发现新增了三个文件

• LoadBalance.war: 上次重部署成功的war包
• LoadBalance.war.1: 部署成功的war记录
• SUCCESSBID: 部署成功的记录

[admin@localhost backup]# pwd
/var/data/.jenkins/backup
[admin@localhost backup]# ls ./LB-free-svn-remote/
LoadBalance.war LoadBalance.war.1 SUCCESSBID

4. 注意:

• 新建local-remote 模式任务时, 需要在系统设置中配置远程Linux 服务器信息
• 复制此模式项目时, 不仅需要修改参数化定义的值即可,还得修改源码模块儿的svn 信息
• Publish Over SSH 中Source file 只能写相对路径, 不能写绝对路径,相对于当前工作空间目录, 否则会上传不了文件, 笔者在此栽了不少跟头.
• svn 服务有两种方式, 体现在url 上是 http:// 和 svn:// , 当路径为 svn:// 时, 触发器不能使用Poll SCM 模式, 因为无论是否发生变化, 都会进行重新部署, 这或许是jenkins 不能解决的一个bug吧.
• svn 服务器建议一个war包放在一个单独的文件夹中, 因为svn 下载的时候是以文件夹为单位的, 会下载同一个文件夹中的所有文件.

附:完整配置示例