Jenkins的plugin开发

Jenkins强大的功能主要靠其丰富的plugin体现，之前的一篇博客《Jenkins安装plugin》中介绍了如何找到并安装需要的plugin。虽然目前已经有大量非常优秀的plugin可供使用，但是有时候仍需要自己开发一些满足项目特殊要求的plugin。下面通过一个简单实例，介绍Jenkins的plugin的整个开发过程。

1. 环境准备

1) 安装工具: Maven 3; JDK 6.0或以上版本，Eclipse SDK 4.2

2) 环境变量：PATH中添加mvn.bat路径；JAVA_HOME中添加SDK路径

3) 修改maven安装目录下conf文件夹中的settings.xml，添加如下配置：

<settings>

  <pluginGroups>

    <pluginGroup>org.jenkins-ci.tools</pluginGroup>

  </pluginGroups>

  <profiles>

    <!-- Give access to Jenkins plugins -->

    <profile>

      <id>jenkins</id>

      <activation>

        <activeByDefault>true</activeByDefault> <!-- change this to false, if you don't like to have it on per default -->

      </activation>

      <repositories>

        <repository>

          <id>repo.jenkins-ci.org</id>

          <url>http://repo.jenkins-ci.org/public/</url>

        </repository>

      </repositories>

      <pluginRepositories>

        <pluginRepository>

          <id>repo.jenkins-ci.org</id>

          <url>http://repo.jenkins-ci.org/public/</url>

        </pluginRepository>

      </pluginRepositories>

    </profile>

  </profiles>

  <mirrors>

    <mirror>

      <id>repo.jenkins-ci.org</id>

      <url>http://repo.jenkins-ci.org/public/</url>

      <mirrorOf>m.g.o-public</mirrorOf>

    </mirror>

  </mirrors>

</settings>

2. 创建plugin

在命令行窗口中执行命令：mvn hpi:create，创建plugin项目的目录结构和POM文件。会提示输入groupId（相当于Java代码的package name）和artifactId（相当于Java代码的project name），如下图所示：

上面红色方框中就是提示输入groupId和artifactId的地方，下面红色方框的"BUILD SUCCESS”表示plugin项目创建成功。

3. 编译plugin

编译plugin项目，有两种方式，一种是用Maven命令方式，另一种是将plugin项目导入到Eclipse的方式。前者只需要执行一条Maven命令，如果不必编辑plugin项目的代码，这种方式非常方便。后者需要额外准备Eclipse开发环境，并需要Maven的Eclipse plugin将Eclipse和Maven关联起来，但是这种方式适合于对Eclipse比较熟的开发者。

3.1 Maven命令方式

在命令行窗口中plugin项目的目录下执行mvn package命令，会编译plugin项目，同时创建jar包和hpi文件。

3.2 导入到IDE方式

打开Eclipse，选择“File”->“import”->“Maven”->“Existing Maven Projects”，选择上步中Maven创建的文件夹myplugin，点击“ok”，如下图所示：

Eclipse会分析pom.xml文件并生成Java项目文件，忽略import过程中的warnings。Maven项目导入Eclipse之后的目录结构如下图所示：

在Maven build项目之前，必须先对项目Maven clean，这样才能保证自己开发的plugin在部署到Jenkins之后能够看得到，目前还不清楚为什么需要有这么一步。执行Maven clean和Maven build的方式是右击plugin项目，选择Run As -> Maven clean或者Maven build，如下图所示：

4. 测试Plugin

在命令行窗口中plugin项目的目录下执行mvn hpi:run，Maven会在Jetty中启动一个测试Jenkins，并将新开发的plugin部署到Jenkins中，在浏览器地址栏中输入http://localhost:8080/jenkins即可进入测试Jenkins。前面创建的plugin项目，只是输出你的名字，其他什么事情也没做，下面对其进行测试。

创建测试job：

在build step中选择"Say hello world"项（新开发plugin提供）：

输入你的名字：

测试结果：

Reference

Plugin tutorial

Jenkins插件开发入门资料收集