autoConfig操作文档.docx

Autoconfig操作文档Autoconfig:自动化的配置工具发布工具autoconfig使用一套配置模板，为不同的环境生成相应的具体配置。它的核心思想是把一些可变的配置定义为一个模板，在autoconfig运行的时候从这些模板中生成具体的配置文件。auto-config的核心技术是volicty的模板技术，包括里面的占位符oplacehold都是以$volicty的语法定义的auto-config主要涉及的文件有以下部分：auto-config.xml，template.vm(模板),perty(需要替换的文件)auto-config.xml主要定义那些字符需要替换，他们的默认值是什么，那些文件需要替换占位符，以及输出的文件 template.vm(可选配置) 主要定义模板文件，其实就是我们需要的配置文件，只不过这里需要替换的符号都以占位符的形 式输出perty 定义了占位符中 的具体的值用于替换占位符的值autoconfig支持两种运行方式:非开发的应用测试人员、发布应用的系统管理员来说，最好的方法是使用第一种独立可执行的AutoConfig来配置应用目标文件。第一种:安装应用软件 通过普通的java命令行来调用第二种:在pom文件中添加eclipse maven插件来运行。第一种操作方式:需要下载autoconfig应用软件安装后进行操作。待补充！如下主要介绍第二种操作方式1. 首先在maven工程的pom文件中添加 autoConfig插件 例: com.alibaba.citrus.toolautoconfig-maven-plugin$autoconfig-plugin-version$user.dir/src/main/resources/$perties!- 要进行AutoConfig的目标文件，默认为$project.artifact.file。 $project.artifact.file -!- 配置后，是否展开目标文件，默认为false，不展开。 true -!- 展开到指定目录，默认为$project.build.directory/$project.build.finalName。 $project.build.directory/$project.build.finalName -src/main/webappWEB-INF/*.xmltruesrc/main/webappWEB-INF/*.xmlpackageautoconfig2. 创建auto-config.xml主要定义那些字符需要替换，他们的默认值是什么，那些文件需要替换占位符，以及输出的文件 例:3. 添加模板文件perties该文件目录可放在 src/main/rosources 或web-info下 ，模板文件可是*.properties 、*.xml 等 例:petstore.work=$petstore.workpetstore.loggingRoot=$petstore.loggingRootpetstore.upload=$petstore.uploadpetstore.loggingLevel=$petstore.loggingLevel4. 添加需要替换环境的配置文件 例:本地环境文件(perties):petstore.work=D:/workspace/ maven-autoconfig-demopetstore.loggingRoot=C:/logpetstore.upload=C:/sftppetstore.loggingLevel=info测试环境文件(perties)petstore.work= home/htyf/petstore.loggingRoot= home/htyf/log/petstore.upload= home/htyf/sftp/petstore.loggingLevel=info5. 在maven中添加文件环境配置域 perties 注意:此文件目录是在添加autoconfig插件时指向的6. Mvn命令操作到此 一些配置已经添加完毕，运行时通过mvn命令进行打包,每次执行mvn package或者mvn install时，都会激活AutoConfig，对package目标文件进行配置。想要避免AutoConfig，只需要一个额外的命令行参数：避免执行AutoConfig 输入命令如：mvn install Dautoconfig.skip 当aotuconfig打包出现错误以后，Maven会报错，并停止build过程。假如你不希望maven停止，可以用下面的命令来执行mavenmvn . Dautoconfig.strict=false该配置打包命令 mvn package P local / test ,id取用pom文件中的 profile local中的。 环境根据自行需要配置7. 常见问题a) 此类打包每次必须指定 那种版本配置 如不指定 可以通过手动的方式添加 如下: 选择 y 之后出现根据导向操作完会生成一个 变量文件，内容是需要替换的值。8. 备注a)