1. <pluginGroups>
2. <pluginGroup>org.jvnet.hudson.tools</pluginGroup>
3. </pluginGroups>
4. <profiles>
5. <profile>
6. <id>hudson</id>
7. <activation>
8. <activeByDefault />
9. </activation>
10. <pluginRepositories>
11. <pluginRepository>
12. <id>m.g.o-public</id>
13. <url>http://maven.glassfish.org/content/groups/public/</url>
14. </pluginRepository>
15. </pluginRepositories>
16. <repositories>
17. <repository>
18. <id>m.g.o-public</id>
19. <url>http://maven.glassfish.org/content/groups/public/</url>
20. </repository>
21. </repositories>
22. </profile>
23. </profiles>
24. <activeProfiles>
25. <activeProfile>hudson</activeProfile>
26. </activeProfiles>

这样会将你的Maven指向有着Hudson-related Maven plugins的仓库，而且允许你使用Hudson Maven plugins的短名字来调用相关的插件(例如:hpi:create 代替org.jvnet.hudson.tools:maven-hpi-plugin:1.23:create)。

接着在CMD中输入

1. mvn hpi:create

1. mvn -DdownloadSources=true eclipse:eclipse

然后你就可以在Eclipse中导入这个项目并开始开发了。Eclipse导入maven工程，需要安装maven插件，然后在工程里选择导入已有项目即可。

1. + src
2. + main
3. + java
4. +  full.package.name
5. +- HelloWorldBuilder.java
6. +resources
7. +  full.package.name
8. +- config.jelly
9. +- global.jelly
10. +- index.jelly
11. + webapp
12. +- help-globalConfig.html
13. +- help-projectConfig.html

这个类就是具体实现某一扩展点的一个类，在这里由于要扩展Builder这个扩展点，所以继承了 Builder 这个类。在Hudson 中有很多不同种类的扩展点，比如Publisher、Recorder 等等。详细的说明可以参考Hudson 的网站。

下面我来逐步分析这些代码

这段代码用于构造这个Bulider并且从相应的config.jelly中获取相应的参数。Hudson使用了一种叫structured form submission的技术，使得可以使用这种方式活动相应的参数。

方法perform（）是个很重要的方法，当插件运行的的时候这个方法会被调用。相应的业务逻辑也可以在这里实现。比如这个perform（）方法就实现了怎么说　“Hello”

接下来，在HelloBuilder 这个类里面有一个叫 DescriptorImpl 的内部类，它继承了Descriptor。在Hudson 的官方说明文档里说Descriptor包含了一个配置实例的元数据。打个比方，我们在工程配置那里对插件进行了配置，这样就相当于创建了一个插脚的实例，这时候就需要一个类来存储插件的配置数据，这个类就是Descriptor。

如同注释属所说，这个方法用于将全局配置存储到项目中

注意点：

HUDSON_HOME：

Hudson需要一个位置来进行每次构建，保留相关的配置信息，以及保存测试的结果，这就是在部署好了Hudson环境以后，系统就会自动在当前用户下新建一个.hudson，在linux下如：~/.hudson，我们有三种方式来改变这个路径：

1.  在启动servlet容器之前，设置：“HUDSON_HOME”环境变量，指向你需要设定的目录

2.  在servlet容器之中，设定系统属性

3.  设置一个JNDI的环境实体<env-entry>“HUDSON_HOME”指向您所想要设定的目录

目前我们在glassfish中设置jvm-option的方式属于第二种。

当我们设置好这个变量以后想要换个目录，但又不想丢掉以前的配置怎么办，很简单，关闭Hudson，将目录A的内容拷贝的目录B中去，然后重新设定“HUDSON_HOME”的值，然后重启，你会发现之前你所作的所有配置都完好的保留了下来

1、Hudson-home的目录结构：

HUDSON_HOME

+- config.xml     (hudson的基本配置文件，如：jdk的安装路径)

+- *.xml          (其他系统相关的配置文件，比如：旺旺插件的全局配置信息)

+- fingerprints   (储存文件版本跟踪记录信息)

+- plugins        (存放插件)

+- jobs

+- [JOBNAME]      (任务名称，对应页面上的project name)

+- config.xml     (任务配置文件，类似于CC的config.xml中各个项目的配置)

+- workspace      (SCM所用到的目录，hudson所下载代码默认存放在这个目录)

+- builds

+- [BUILD_ID]     (每一次构建的序号)

+- build.xml      (构建结果汇总)

+- log            (运行日志)

+- changelog.xml  (SCM修改日志)

小提示：如果你使用了e-mail来接受测试消息，并且hudson的迁移设计到不同ip地址机器的迁移的话，可能需要去Hudson的主配置中修改一下Hudson的访问地址

workspace：

刚才在hudson-home的目录结构中已经看到了workspce，假设当前hudson-home为/home/hudson-home，那么当我们在hudson上配置一个项目demo的时候，就会在新建一个目录/home/hudson-home/demo，在第一次运行之前，在jobs下并没有demo这个文件夹,只有当第一次运行以后才会在jobs目录下创建demo目录，当代码顺利从svn上下载下来时才会创建workspace文件夹，所有从svn下载下来的代码都会存放在这个目录下。

1、相对路径：

项目配置过程中，Hudson使用的是相对路径，对于Hudson，在我们新建一个项目比如demo后，假设workspace的目录结构为：

workspace

+- demo

+- pom.xml

+- src

那么测试报告的路径就为demo/target/surefire-reports/*.xml,系统会自动去当前项目的workspace中去寻找这个路径

mvn package  -- 完成代码开发之后执行，按照pom.xml 中的配置信息将会打包为hpi 格式的插件文件，这个就是你最终可以拿来上传给你的hudson 平台的玩意

mvn hpi:run   -- 在本地的Jetty 中运行你的hudson 插件，调试专用，当然可以使用Debug 模式，执行之后，在本地访问http://localhost:8080/ 即可见（注意不要占用8080 端口）

mvnDebug hup:run ，debug调试模式

1. package zygroup;
2. import hudson.FilePath;
3. import hudson.Launcher;
4. import hudson.Extension;
5. import hudson.Proc;
6. import hudson.util.FormValidation;
7. import hudson.model.AbstractBuild;
8. import hudson.model.BuildListener;
9. import hudson.model.AbstractProject;
10. import hudson.remoting.Channel;
11. import hudson.tasks.Builder;
12. import hudson.tasks.BuildStepDescriptor;
13. import net.sf.json.JSONObject;
14. import org.kohsuke.stapler.DataBoundConstructor;
15. import org.kohsuke.stapler.StaplerRequest;
16. import org.kohsuke.stapler.QueryParameter;
17. import javax.servlet.ServletException;
18. import java.io.IOException;
19. public class HelloWorldBuilder extends Builder {
20. private final String locate;
21. private final String cmd;
22. // Fields in config.jelly must match the parameter names in the "DataBoundConstructor"
23. @DataBoundConstructor
24. public HelloWorldBuilder(String locate, String cmd) {
25. this.locate = locate;
26. this.cmd = cmd;
27. }
28. /**
29. * We'll use this from the <tt>config.jelly</tt>.
30. */
31. public String getLocate() {
32. return locate;
33. }
34. public String getCmd() {
35. return cmd;
36. }
37. @Override
38. public boolean perform(AbstractBuild build, Launcher launcher, BuildListener listener) {
39. listener.getLogger().println("The SLiM build home is "+locate+".");
40. listener.getLogger().println("The SLiM build command is "+cmd+".");
41. try {
42. FilePath path = new FilePath(Channel.current(),locate);
43. Proc proc = launcher.launch(cmd, build.getEnvVars(), listener.getLogger(),path);
44. int exitCode = proc.join();
45. if (exitCode != 0) return false;
46. return true;
47. } catch (IOException e) {
48. e.printStackTrace();
49. listener.getLogger().println("IOException !");
50. return false;
51. } catch (InterruptedException e) {
52. e.printStackTrace();
53. listener.getLogger().println("InterruptedException!");
54. return false;
55. }
56. }
57. @Override
58. public DescriptorImpl getDescriptor() {
59. return (DescriptorImpl)super.getDescriptor();
60. }
61. @Extension // this marker indicates Hudson that this is an implementation of an extension point.
62. public static final class DescriptorImpl extends BuildStepDescriptor<Builder> {
63. public FormValidation doCheckName(@QueryParameter String value) throws IOException, ServletException {
64. if(value.length()==0)
65. return FormValidation.error("Please set a name");
66. if(value.length()<4)
67. return FormValidation.warning("Isn't the name too short?");
68. return FormValidation.ok();
69. }
70. public boolean isApplicable(Class<? extends AbstractProject> aClass) {
71. // indicates that this builder can be used with all kinds of project types
72. return true;
73. }
74. public String getDisplayName() {
75. return "SLiM build";
76. }
77. @Override
78. public boolean configure(StaplerRequest req, JSONObject formData) throws FormException {
79. save();
80. return super.configure(req,formData);
81. }
82. }
83. }

1. <j:jelly xmlns:j="jelly:core" xmlns:st="jelly:stapler" xmlns:d="jelly:define" xmlns:l="/lib/layout" xmlns:t="/lib/hudson" xmlns:f="/lib/form">
2. <!--
3. This jelly script is used for per-project configuration.
4. See global.jelly for a general discussion about jelly script.
5. -->
6. <!--
7. Creates a text field that shows the value of the "name" property.
8. When submitted, it will be passed to the corresponding constructor parameter.
9. -->
10. <f:entry title="Build Home" help="plugin/zyartifact/WEB-INF/classes/zygroup/HelloWorldBuilder/help-buildhome.html">
11. <f:textbox name="locate" type="text" value="${instance.locate}"/>
12. </f:entry>
13. <f:entry title="Build Command" help="plugin/zyartifact/WEB-INF/classes/zygroup/HelloWorldBuilder/help-cmd.html">
14. <f:textbox name="cmd" type="text" value="${instance.cmd}"/>
15. </f:entry>
16. </j:jelly>

1. public boolean perform(AbstractBuild build, Launcher launcher, BuildListener listener) {
2. /向hudson运行控制台输出日志信息
3. listener.getLogger().println("The SLiM build home is "+locate+".");
4. listener.getLogger().println("The SLiM build command is "+cmd+".");
5. try {
6. //将locate字符串转化为hudson的FilePath类型
7. FilePath path = new FilePath(Channel.current(),locate);
8. //在path路径下执行cmd命令
9. Proc proc = launcher.launch(cmd, build.getEnvVars(), listener.getLogger(),path);
10. //如果shell结果为失败，则返回失败
11. int exitCode = proc.join();
12. if (exitCode != 0) return false;
13. //返回成功
14. return true;
15. } catch (IOException e) {
16. ......
17. }
18. }

1. public String getDisplayName() {
2. return "SLiM build";
3. }

1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
2. <modelVersion>4.0.0</modelVersion>
3. <parent>
4. <groupId>org.jvnet.hudson.plugins</groupId>
5. <artifactId>hudson-plugin-parent</artifactId>
6. <version>2.1.1</version><!-- which version of Hudson is this plugin built against? -->
7. </parent>
8. <groupId>zygroup</groupId>
9. <artifactId>zyartifact</artifactId>
10. <version>1.0-SNAPSHOT</version>
11. <packaging>hpi</packaging>
12. <name>SLiM build</name>
13. </project>