liujiah / svnbasedpatchcq

重庆增量版本工具

基于SVN的自动化增量抽取工具

简述

17年底开发的基于Git提交日志的自动化增量抽取工具当前已在几个项目中投入使用，效果反馈还不错。由于至今有部分遗留项目由于某些原因仍使用SVN作为版本控制工具，为增加增量机制，开发了本工具。

基于之前的Git自动化增量抽取工具的开发经验及后续需求调整，本工具开发用时一周时间，新增一些配置化功能，具体如下：

功能描述

• 流程分为生成增量描述文件、根据增量描述文件抽取生成增量部署包两个阶段；
• 单一工程单个SVN地址配置文件简化；
• 复合工程多模块对应多个SVN地址支持；
• 通用pom解析jar包抽取和个性化yml配置文件过滤规则；（新）
• 某一子文件夹的全部抽取yml配置文件支持；（新）
• maven依赖的三方包的抽取支持；
• Excel送测清单自动生成；（新）

TODO列表

• 1、svn的url与jenkins本地路径转换 ---- DONE
  • pom文件直接从svn服务器端获取并解析出jar包名称
• 2、根据pom自动生成增量清单 ---- DONE
• 3、增量包抽取生成 ---- DONE

使用说明

生成增量描述文件和增量部署包相关命令如下：

# 生成增量描述文件和送测清单
java -jar svn-patchtool.jar xml [yml_prefix] [workspace] [versionFrom] [versionTo]

# 读取增量描述文件，抽取生成增量部署包
java -jar svn-patchtool.jar zip [yml_prefix] [workspace] [versionFrom] [versionTo]

配置说明

配置svn.properties文件：

############################## 增量抽取多套配置部分 ##############################

# svn相关配置信息
svn.username=
svn.password=
# SVN项目的服务器地址
svn.url=

# 增量送测清单存放相对路径（其中@代表项目跟路径）：${workspace}/${patch.excel.dir}
patch.excel.dir=
# 增量描述文件存放路径（其中@代表项目跟路径）：${workspace}/${patch.xml.dir}
patch.xml.dir=
# 增量描述文件模块后缀：${workspace}/${patch.xml.dir}/[yyyyMMdd]_${versionFrom}-${versionTo}_${patch.xml.surfix}.xml
patch.xml.surfix=

################################ 以下为通用配置 ################################

# 三方增量包读取相对路径（其中@代表项目跟路径）：${workspace}/${patch.yml.dir}
patch.yml.dir=
# 三方增量包读取后缀：${workspace}/${patch.yml.dir}/${yml_prefix}${patch.yml.surfix}.yml
patch.yml.surfix=
# 抽取增量的源（全量目标码路径）：${workspace}/${patch.src.dir}
patch.src.dir=
# 生成的增量包存放路径：${workspace}/${patch.target.dir}
patch.target.dir=
# 增量部署包名称：${workspace}/${patch.target.dir}/${patch.zip.name}
patch.zip.name=
# 创建临时文件夹，用于中转增量包（文件目录防止重名）：${workspace}/${patch.tmp.folder.name}
patch.tmp.folder.name=
# 增量包生成压缩包前的外层文件夹名：${workspace}/${patch.tmp.folder.name}/${patch.folder.name}
patch.folder.name=
# 增量部署包附带的增量列表名称：${workspace}/${patch.tmp.folder.name}/${patch.folder.name}/${deleteFile.name}
deleteFile.name=deleteList.txt

confContext.xml配置，以下为一套配置

    <bean id="svnDao" class="com.dcits.patchtools.svn.dao.SvnDao">
        <property name="svnUrl" value="${svn.url}"/>
        <property name="user" value="${svn.username}"/>
        <property name="pwd" value="${svn.password}"/>
    </bean>
    <bean id="svnService" class="com.dcits.patchtools.svn.service.impl.SvnServiceImpl">
        <property name="svnDao" ref="svnDao"/>
    </bean>
    <bean id="patchService" class="com.dcits.patchtools.svn.service.impl.PatchServiceImpl">
        <property name="svnService" ref="svnService"/>
        <property name="pathRuleService" ref="pathRuleService"/>
        <property name="xmlDir" value="${patch.xml.dir}"/>
        <property name="xmlModuleSurfix" value="${patch.xml.surfix}"/>
        <property name="excelDir" value="${patch.excel.dir}"/>
    </bean>

applicationContext.xml配置，当配置多套时需将每一套的PatchService注入到PatchHandler：

    <property name="patchServices">
        <list>
            <!-- 当有多套svn地址，每一套PatchService的id在此注册 -->
            <ref bean="patchService"/>
        </list>
    </property>

规则文件patchRule.yml相关配置：

# 增量抽取需求：
# 1、生成增量包的同时，生成Excel的增量清单
# 2、环境相关的文件处理：部署包中不体现，在增量清单中体现

# 匹配路径并转换 匹配srcPath后，转换module路径
pathConvert:
  # 匹配具体文件
  specific:
  # 包含路径匹配
  contains:
    /src/main/scripts/: bin/
    /src/main/java/: lib/
    /src/main/config/: lib/
    /src/main/resources: lib/
  # 前缀路径匹配
  prefix:
  # 后缀路径匹配
  surfix:
    .jar: lib/

# 要过滤掉的路径
pathExclued:
  specific:
  contains:
    - /src/test/
    - /src/main/rules/META-INF/
  prefix:
  surfix:
    - assembly.xml
    - .txt
    - .bak
    - .sql
    - .xls
    - .xlsx
    - .doc
    - .docx
    - .pdf
    - .md
    - .log
    - .yml
    - .iml
    - .classpath
    - .project
    - .json
    - .xmind
    - .cdm
    - .ftl
    - .trg
    - .er
    - .jar
    - .gif
    - .jpg
    - .png

# 仅在增量清单中体现，不进入增量部署包
listOnly:
  specific:
  contains:
    - /src/main/config/ext/
    - /src/main/config/business/
  prefix:
  surfix: [.sh, .bat, .properties, logback.xml]

# 指定目录下全量抽取（仅抽取文件，不递归子目录）
# (1) 源目录抽取到指定目标目录：
#   srcFolder：destFolder
patchFull:
  conf/check: conf/check
  conf/mapping: conf/mapping

实现机制

生成增量描述文件

抽取增量生成增量部署包