当Hudson遇上php

最近在使用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>

—–未完待续————

《当Hudson遇上php》有一个想法

  1. 你好,有个问题请教一下,
    已经安装了xunit plugin,hudson中应该如何配置?
    还有就是phpunit的测试结果在哪里呢?

发表评论

电子邮件地址不会被公开。 必填项已用*标注