Hudson 插件编纂

2012-09-02

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

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中的前面一个eclipsecreate：这是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
1 楼 jackyneo 2011-12-26 本地调试的时候要确保端口没被调用，否则就悲剧了 2 楼 jackyneo 2011-12-26 最近来考虑自己写个插件。。。满足SCM和一帮人的要求，尼玛，又当开发又搞测试，一种又当爹又当妈的感觉。。。 3 楼 Trinea 2011-12-26 jackyneo 写道最近来考虑自己写个插件。。。满足SCM和一帮人的要求，尼玛，又当开发又搞测试，一种又当爹又当妈的感觉。。。
mvn hpi:run -Djetty.port=8090 这个命令是改启动端口的
简单的插件好写，但对于不同的扩展点要实现的函数略有不同，这些文档还不好找，有点麻烦，我们这边有不少扩展点其他人已经写好了的插件，到时候你需要可以找我

热点排行

编程

Hudson 插件编纂