最近在使用Hudson帮助团队建立每日构建环境,这里梳理一下使用hudson作为php的ci平台一些要点和注意事项。
1. 如果采用直接运行hudson.war的方式,hudson会默认创建.hudson目录,并将war解压缩在该目录下,同时把.hudson作为 HOME目录。.hudson是个隐藏目录,会带来一些不必要的麻烦,例如:phpunit3.4无法识别对隐藏目录下的测试代码目录。可以通过设置 HUDSON_HOME环境变量来改变,例如:
export HUDSON_HOME=/hudson/home
如果你已经配置好了Hudson,担心修改目录会导致重新配置,可以直接把.hudson目录内容打成一个tar包,解压缩到新的HUDSON_HOME下,所有的配置就会和原来一模一样。
2. Hudson的svn插件使用的是svnkit,svnkit对于Negotiate (sspi) authentication的处理有一些问题,如果你的svn server上启用了对于windows 域用户的鉴权,那么你在配置Subversion Authentication时,即使你输入正确的用户名和密码,hudson还是会提示你:
Failed to authenticate: svn: OPTIONS of ‘svn:/trunk’ 401 Authorization Required FAILED: svn: Authentication failed for…
解决办法是:强制指定svnkit使用BASIC和NTLM鉴权,在启动hudson时,增加启动参数:
java -Dsvnkit.http.methods=Basic,NTLM -jar hudson.war
具体解释可以参考:Getting Hudson to work with SVN on Apache and mod_sspi
3. svn reposity 的本地目录修改后,hudson会自动清空workspace,因此你的ant构建脚本(例如:ci_build.xml)最好不要放在workspace目录下,可以放到workspace的上层目录中。
4. 一般我们希望在linux将hudson作为一个daemon运行,可以在启动时增加参数实现:
java -jar hudson.war –daemon
5. php的每日构建需要:
1)代码静态检查 – phpCodeSniffer:
a. 需安装Checkstyle plugin,注意如果你是手工安装的话,它依赖于analysis-core 插件
b. 如果是手工安装phpCodeSniffer, 注意修改phpcs.php,将@php_bin@替换为你的php可执行文件路径
C. phpcs会把生成的分析也显示出来,产生大量的Log信息,可以通过redirector定向到文件中,不显示在命令行的Log中,例如:
<target name="phpcs">
<exec dir="${basedir}"
executable="phpcs"
failonerror="false" >
<arg line="–report=checkstyle –report-file=${basedir}/build/logs/checkstyle.xml -n source/app/MyApp.php"/>
<redirector output="${basedir}/build/logs/temp.log" />
</exec>
</target>
2) API文档自动生成–phpDocumentor
a. 在使用时注意,–ignoresymlinks 外部代码不用生成注释 –quiet 过程提示不输出
3)单元测试–phpunit
a. hudson要正确的解析phpunit的生成的报告,需要先安装xunit plugin,否则会无法解析生成report,导致构建失败。
b.如果要生成代码覆盖率报告,需要先安装clover plugin,注意phpunit需要xdebug扩展才能生成clover报告
<target name="phpunit">
<exec dir="${basedir}"
executable="phpunit"
failonerror="true">
<arg line="–log-junit build/logs/junit.xml
–coverage-clover build/logs/clover.xml
source/tests"/>
</exec>
</target>
—–未完待续————