Hudson 插件编写

Hudson是一个开源的持续集成工具，由于其强大的扩展性（插件）而著名，允许用户定制build的各个step，steps如下：

• SCM checkout - Based on SCM type, source code is checked out
• Pre-build - Invoked to indicate that the build is starting
• Build wrapper - Prepare an environment for the build.
• Builder runs - Actual building like calling Ant, Make, etc. happen.
• Recording - Record the output from the build, such as test results.
• Notification - Send out notifications, based on the results determined so far

下面主要介绍怎么新建一个简单的hudson插件以及插件中的主要代码功能

1、新建一个简单hudson插件

1.1 ~/.m2/settings.xml文件中增加pluginGroup，如下：

<pluginGroups>
	……
    <pluginGroup>org.jvnet.hudson.tools</pluginGroup>
	……
</pluginGroups>

加入这一行信息可以在我们使用Hudson的maven插件时使用缩略名（比如.使用hpi:create代替org.jvnet.hudson.tools:maven-hpi-plugin:1.23:create）

 

1.2 新建工程

使用如下命令

mvn hpi:create

hpi: 是Hudson Plug-in Interface的缩写，这是Hudson自己开发的用来进行插件开发的maven插件，就像大家经常用的mvn eclipse:eclipse中的前面一个eclipse

create：这是Hudson HPI插件用来生成Hudson插件原型项目的goal

关于mvn相关概念可以参考：http://trinea.iteye.com/blog/1290898

过程中会提示输入groupId和artifactId，输入自己的即可

这样一个HelloWorldBuilder就已经创建好了，导入eclipse可以查看源码

这里有点需要注意， 貌似hudson默认构建的Builder代码有问题，大家可以自己试下， 我这边需要在HelloWorldBuilder类中加入如下代码方能正确得到结果，否则在1.5步中的配置时无法看见新添加的builder。

 public static DescriptorImpl descriptor() {
        return Hudson.getInstance().getDescriptorByType(HelloWorldBuilder.DescriptorImpl.class);
    }

以上代码中的 HelloWorldBuilder为当前类名

1.3 打包

命令如下：

mvn package

在target目录下生成了一个*.hpi和一个*.jar文件，见过hudson插件的都知道，hpi后缀为hudson插件文件。现在我们就可以将hpi文件添加到hudson中作为插件，不过不急，我们用命令自动运行

1.4 运行

命令如下：

mvn hpi:run

这个命令会启动jetty，并且将hudson作为一个web应用启动，启动hudson前安装当前的插件到hudson中

当前项目根目录下的work文件夹作为hudson home，可以在其中找到用于存放插件的plugins文件夹

1.5 查看结果

项目成功启动、jetty成功启动后我们可以通过

http://localhost:8080

访问hudson主页，其中8080为jetty启动默认端口，若端口被占用，可以在上面运行命令中添加参数指定端口，如下

mvn hpi:run -Djetty.port=8090

修改启动端口为8090

在hudson主页左边菜单栏有 新建任务菜单，点击新建工程，选择 构建一个自由风格的软件项目，输入名称后ok即可。之后就进入新建的项目配置中。

在 配置的Build区域，点击 Add build step，打开下拉菜单我们可以看见 Say hello world这个Builder。这个就是我们的插件。Say hello world为插件中设置的显示名。选中这个Builder，填入name保存后，点击菜单栏的 立即构建开始运行。在结果的命令行输出中会输出Hello, 加上我们刚才输入的name。

到此一个简单的插件就完成了 ，下面介绍下代码

2、插件中主要代码介绍

2.1 继承相应的扩展点extension Point

hpi中有个概念叫extension Point。就是说你要扩展哪方面。

由于mvn hpi:create默认扩展自扩展Builder这个扩展点，所以HelloWorldBuilder继承了Builder这个类。

其他扩展点会继承其他类，如post build action需要继承Notifier

 

2.2 实现perform方法

方法perform()是个很重要的方法，当插件运行的的时候这个方法会被调用。相应的业务逻辑也可以在这里实现。

 

2.3 继承Descriptor

新建DescriptorImpl类继承了BuildStepDescriptor<Builder>,BuildStepDescriptor继承自Descriptor。在Hudson 的官方说明文档里说Descriptor包含了一个配置实例的元数据。

打个比方，我们在工程配置那里对插件进行了配置，这样就相当于创建了一个插件的实例，这时候就需要一个类来存储插件的配置数据，这个类就是Descriptor。

 

其中的getDisplayName()表示在配置中插件展现的名字，如同上面1.5查看结果中我们看到的配置中build下拉框的Say hello world

 

3、debug调试

用mvn -Dhudson.maven.debugPort=5001 hpi:run启动jetty

或者修改maven启动参数

-Xdebug -Xrunjdwp:transport=dt_socket,server=y,address=5001

具体见：http://wiki.hudson-ci.org/display/HUDSON/Debugging+native+Maven+jobs

 

更多参考如下：

http://wiki.hudson-ci.org/display/HUDSON/Extend+Hudson

http://wiki.eclipse.org/Hudson-ci/writing-first-hudson-plugin

http://wiki.hudson-ci.org/display/HUDSON/Plugin+tutorial

http://qa.taobao.com/?p=4925

http://drizzlewalk.blog.51cto.com/2203401/499586