当前位置: 代码迷 >> Web前端 >> 第一次亲密接触"兑现Web平台升级的傻瓜化
  详细解决方案

第一次亲密接触"兑现Web平台升级的傻瓜化

热度:398   发布时间:2012-09-21 15:47:26.0
第一次亲密接触"--实现Web平台升级的傻瓜化

  记得自己解决过的最复杂的一个问题就是:通过安装包的方式,为Web平台打补丁或者升级

  用户场景:

  客户的Web平台在升级的时候,一般是这样:维护人员发布一个补丁包和说明文档。用户按照说明文档进行操作,覆盖服务器上的相关目录下的文件等等(此处省略一千个字)。如果涉及到数据库更新的话,还需要用户手动执行sql更新数据库。

这样的操作非常繁琐,用户一不小心就可能弄错 。所以要求我将补丁包制作成exe(Linux下为sh)的格式,用户只要点击下一步就可以完成所有的操作。

  粗略的需求:

  下面我来粗略的说一下需求:

  1. 软件要适用于Win平台和Linux平台
  2. 自动备份用户的Web平台
  3. 更新失败要能够回滚
  4. 能够根据选择,自动更新各个常用的数据库,比如oracle,mysql,达梦,金仓等等
  5. 出错记录日志
  6. 记录补丁安装信息,并且能够进行补丁间依赖关系识别

  这些只是我们根据用户的描述,粗略整理出来的。(其实用户最想要的是类似360安全卫士那样的软件,自动给Web平台打补丁或者升级,什么都不用他操心)。

  用户的固然想法很好,但是鉴于成本和时间,根本无法完成。

  甲方虐我千百遍,我待甲方如初恋。为了尊重用户的意见,只好修改设计文档,规划了三个阶段去实现用户最终想要的那个产品。

一份详细的需求文档,改了八版才审核通过。真不知道人家是真虐着咱玩儿呢,还是时间真的很富裕。有将近一个月的时间,都在写文档。虽然繁琐了一些,不过多亏了这些文档,和用户也好,和测试也好,不会浪费更多的口舌。

  附一张升级工作流程图

  思路和相关技术问题

  这里大概讲一下核心实现的思路,不涉及具体细节了。

  • 关于适用Win平台和Linux平台的问题

  Java本来就是跨平台的语言,所以在Win平台和Linux平台都能正常运行,只不过在处理文件路径时,需要区分一下。但是java运行需要JVM,用户的机器上不一定有。这就需要我们自带JRE。两个平台上需要不用的文件来引导,但是思路都是:使用脚本将自带的JRE设置为JavaHome,设置临时ClassPath,引导Java虚拟机到指定目录下加载入口类。

  • 自动备份用户的Web平台

  这个实现比较简单,根据用户选择的Web平台所在的目录,使用代码将该目录打包。主要使用到java.util.zip.ZipFile这个类

  • 更新失败后的回滚

  Web平台的文件回滚很好办,只要将已经损坏的Web平台目录删除掉,将刚刚备份的文件解包到相应目录即可。

而数据库的回滚比较麻烦,各个数据库需要不同的脚本支持。而且从安全角度出发,也不允许我们自动回滚数据库。所以如果数据库在更新过程中出错,需要用户手动回滚数据库。

  • 自动更新数据库库

  软件支持多少种数据库,就需要带多少种数据库的驱动,并且包含相应的Sql脚本文件。这是软件的核心,也是比较困难的地方。不同的数据库有不同的配置界面,怎么保证扩展和灵活呢?

  一般的解决思路就是使用配置文件,大致格式如下:

<servers>
<server name="Oracle" version="9g/10g" editorPanel="com.yourpackage.gui.db.OracleEditorPanel" jars="ojdbc14-10.2.0.2.0.jar"/>
<server name="KingBase" version="V6.1.1" editorPanel="com.yourpackage.gui.db.KingbaseEditorPanel" jars="kingbasejdbc3.jar"/>
<server name="Mysql" version="V5.1.1" editorPanel="com.yourpackage.gui.db.MySqlEditorPanel" jars="mysql-connector-java-5.1.7-bin.jar"/>
<server name="Dameng" version="V6.0.10.08.27" editorPanel="com.yourpackage.gui.db.DamengEditorPanel" jars="DmJdbcDriver.jar"/> 
<server name="sybase" version="V5.5" editorPanel="com.yourpackage.gui.db.SybaseEditorPanel" jars="sybase_jconn.jar"/>
</servers>

   注: name= 名称,version=版本,editorPanel=数据库配置界面,jars=使用的数据库驱动jar包。

  在配置数据库连接时,将系统支持的数据库加载到下拉列表中,根据用户选择不同的数据库,提供相应的数据库配置界面和驱动,见文章尾部效果图。

  • 记录出错日志

  这个不用多说,使用和配置Log4j,日志利器。

  • 补丁安装信息记录

  补丁安装信息记录也很好办,我们在用户的web平台根目录下,放置一个记录系统安装过的补丁信息的文件。例如名字叫做SystemInfo.xml,格式如下:

<?xml version="1.0" encoding="UTF-8"?>
<!-- 系统名称, 当前版本, 版次 -->
<systeminfo name="Your Product Name" version="V3.1.2" edition="workspace">
<!--安装的补丁信息-->
<installedpatch>
<patch name="Product Name_V3.1.1_201101101745_integrator" publishtime="2011-01-10 00:00:00" installtime="2011-01-15 00:00:00"/>
<patch name="Product Name_V3.1.1_201103101030_integrator" publishtime="2011-03-10 00:00:00" installtime="2011-10-17 00:00:00"/>
</installedpatch>
</systeminfo>


  这个文件可以用来描述用户的系统的名称,版本,版次,已经曾经安装过的补丁。

  • 依赖关系识别

  上面讲了补丁安装信息的记录,那么如何处理补丁间的依赖关系呢?

  每一个补丁可能需要依赖一个或者多个补丁,盲目的打补丁会损坏用户的系统。这里我们同样用一个文件来描述补丁。例如名字叫PatchCfg.xml,格式如下:

<?xml version="1.0" encoding="UTF-8"?>
<-- 如果此补丁适用多个系统版本,请用英文半角逗号分隔,如suitversion=”V3.1.1,V3.1.2” -->
<patchinfo name="PatchName_V3.1.1_201110111530_integrator" suitproduct="Your Product" suitversion="V3.1.1" suitedition="workspace" publishtime="2011-10-11 00:00:00">
<!--依赖的补丁包链,按照发布时间,从早到晚排列,表示当前的补丁包所依赖的全部补丁。如果当前补丁不需要依赖其他补丁,此节点置空即可-->
<dependschain>
<patch name="PatchName_V3.1.1_201101101745_integrator" publishtime="2011-01-10"/>
<patch name="PatchName_V3.1.1_201103101030_integrator" publishtime="2011-03-10"/>
……
</dependschain>
<!--更新的功能列表-->
<functionlist>
<function namekey="FUNCTION01" desc="修复了xxxx不能正常显示的bug"/>
<function namekey="FUNCTION02" desc="在ProductName_V3.1.1版本的基础上支持webservice调用及回调"/>
<function namekey="FUNCTION03" desc="在ProductName_V3.1.1版本的基础上支持根据当前活动计算将要流转到的后继活动api"/>
<function namekey="FUNCTION04" desc="完善ProductName_V3.1.1版本不能创建wsdl文件的问题"/>
<function namekey="FUNCTION05" desc="完善ProductName_V3.1.1版本不能创建wsdl文件的问题"/>
<function namekey="FUNCTION06" desc="在ProductName_V3.1.1版本的基础上增加支持多数据库"/>
</functionlist>
<!--更新的文件列表-->
<filelist>
<!--文件夹覆盖-->
<overwritedir dir="E:\TestOverwrite01\install" todir="E:\TestOverwrite02\install"/>
<overwritedir dir="E:\TestOverwrite03\temp" todir="E:\TestOverwrite04\temp"/>
<!--需要覆盖的文件示例-->
<overwritefile file="E:\TestOverwrite01\install\build.xml" tofile="E:\TestOverwrite02\install\build.xml"/>
<overwritefile file="E:\testOverwrite03\temp\META-INF\log4j-contribution.xml" tofile="E:\testOverwrite04\temp\META-INF\log4j-contribution.xml"/>
<!--需要删除的文件夹示例,目录不存在继续执行-->
<delete dir="E:\TestOverwrite02\install\temp"/>
<!--需要删除的文件示例,文件不存在继续执行-->
<delete file="E:\testOverwrite03\temp\.ess"/>
<!--需要增加的文件示例-->
<addfile="E:\testOverwrite04\temp\.ess" todir="E:\testOverwrite03"/>
<add file="E:\testOverwrite04\temp\META-INF\definitions.xml" todir="E:\testOverwrite03"/>
<!--需要增加的文件夹示例-->
<add dir="E:\testPatch" todir="E:\testOverwrite04"/>
</filelist>
<!--数据库更新脚本,没有配置此节点则默认不升级数据库-->
<updatesql>
<sqlscript dir="${updatedir}\${userDBType}\update.sql"/>
</updatesql>
<!--标识此补丁是否升级系统版本,没有配置此节点则默认不升级-->
<updatesystemversion to="3.1.2"/>
</patchinfo>


  此xml文件则描述了使用的产品名称,版本等信息,并且通过dependschain节点描述了该补丁依赖的其他补丁。只要将dependschain节点下的补丁信息与SystemInfo文件installedpatch节点下的补丁信息进行对比,如果补丁依赖的其他补丁已经安装到了系统中,则该补丁可以安装,否则不允许安装。

  原理图如下:

(依赖关系检测示意图)

  其余节点则描述了更新的功能清单和补丁对文件的操作。

  • 仿ant功能的实现

  在PatchCfg.xml上面我们用xml文件描述了补丁安装工具对于文件的操作,不知道你是否看到了ant的影子呢。没错,我基本是按照ant的风格来描述对文件的各种操作。

但是ant运行是需要配置Java环境的,补丁安装工具需要再自带一个ant工具吗,答案是否定的,用户是不会配置JavaHome的。所有的文件操作需要我们自己编写代码来实现,具体可以参考ant的源码,并不难。

  • 细节

  此外还有一些技术细节,比如使用代码停止各种Web服务器、日志的输出,使用何种框架来配置工作的步骤 ,限于篇幅就不一一展开了。

  有图有真相

  附软件最终截图,基本实现了以安装包的形式,为Web平台升级或者打补丁。用户只需要下一步下一步即可。

开始

选择备份目录

选择手动抑或自动更新数据库

数据库配置界面

预安装摘要

  文件和思路仅供参考,欢迎有相关需求的朋友留言交流。


  原文链接:http://www.67tgb.com/?p=504

  欢迎访问:望月听涛

1楼llhhyy19897小时前
文档很重要蛤,我还没写文档哩,加油哈~
  相关解决方案