Jenkins 插件开发之旅:两天内从 idea 到发布(上篇)
本文首发于:Jenkins 中文社区
本文介绍了笔者首个 Jenkins 插件开发的旅程, 包括从产生 idea 开始,然后经过插件定制开发, 接着申请将代码托管到 jenkinsci GitHub 组织, 最后将插件发布到 Jenkins 插件更新中心的过程。
鉴于文章篇幅过长,将分为上下两篇进行介绍。
从一个 idea 说起
前几天和朋友聊天时,聊到了 Maven 版本管理领域的 SNAPSHOT 版本依赖问题, 这给他带来了一些困扰,消灭掉历史遗留应用的 SNAPSHOT 版本依赖并非易事。
类似问题也曾经给笔者带来过困扰,在最初没能去规避问题, 等到再想去解决问题时却发现困难重重,牵一发而动全身, 导致这个问题一直被搁置,而这也给笔者留下深刻的印象。
等到再次制定 Maven 规范时,从一开始就考虑 强制禁止 SNAPSHOT 版本依赖发到生产环境。
这里是通过在 Jenkins 构建时做校验实现的。 因为没有找到提供类似功能的 Jenkins 插件, 目前这个校验通过 shell 脚本来实现的, 具体的做法是在 Jenkins 任务中 Maven 构建之前增加一个 Execute shell 的步骤, 来判断 pom.xml 中是否包含 SNAPSHOT 关键字,如果包含,该次构建状态将被标记为失败。 脚本内容如下:
#!/bin/bash if [[ ` grep -R --include="pom.xml" SNAPSHOT .` =~ "SNAPSHOT" ]]; then echo "SNAPSHOT check failed" && grep -R --include="pom.xml" SNAPSHOT . && exit 1; else echo "SNAPSHOT check success"; fi
恰好前不久在看 Jenkins 插件开发文档, 那何不通过 Jenkins 插件的方式实现它呢?
于是笔者开始了首个 Jenkins 插件开发之旅。
插件开发过程
Jenkins 是由 Java 语言开发的最流行的 CI/CD 引擎。
说起 Jenkins 强大的开源生态,自然就会说到 Jenkins 插件。 Jenkins 插件主要用来对 Jenkins 的功能进行扩展。 目前 Jenkins 社区有上千个插件, 用户可以根据自己的需求选择合适的插件来定制 Jenkins 。
插件开发准备
插件开发需要首先安装 JDK 和 Maven,这里不做进一步说明。
创建一个插件
Jenkins 为插件开发提供了 Maven 原型。 打开一个命令行终端,切换到你想存放 Jenins 插件源代码的目录,运行如下命令:
mvn -U archetype:generate -Dfilter=io.jenkins.archetypes:
这个命令允许你使用其中一个与 Jenkins 相关的原型生成项目。
$ mvn -U archetype:generate -Dfilter=io.jenkins.archetypes: ...... Choose archetype: 1: remote -> io.jenkins.archetypes:empty-plugin (Skeleton of a Jenkins plugin with a POM and an empty source tree.) 2: remote -> io.jenkins.archetypes:global-configuration-plugin (Skeleton of a Jenkins plugin with a POM and an example piece of global configuration.) 3: remote -> io.jenkins.archetypes:hello-world-plugin (Skeleton of a Jenkins plugin with a POM and an example build step.) Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): : 3 Choose io.jenkins.archetypes:hello-world-plugin version: 1: 1.1 2: 1.2 3: 1.3 4: 1.4 Choose a number: 4: 4 ...... [INFO] Using property: groupId = unused Define value for property 'artifactId': maven-snapshot-check Define value for property 'version' 1.0-SNAPSHOT: : [INFO] Using property: package = io.jenkins.plugins.sample Confirm properties configuration: groupId: unused artifactId: maven-snapshot-check version: 1.0-SNAPSHOT package: io.jenkins.plugins.sample Y: : Y
笔者选择了 hello-world-plugin
这个原型, 并在填写了一些参数,如artifactId、version 后生成了项目。
可以使用 mvn verify
命令验证是否可以构建成功。
构建及运行插件
Maven HPI Plugin
用于构建和打包 Jenkins 插件。 它提供了一种便利的方式来运行一个已经包含了当前插件的 Jenkins 实例:
mvn hpi:run
这将安装一个 Jenkins 实例,可以通过 http://localhost:8080/jenkins/
来访问。 等待控制台输出如下内容,然后打开 Web 浏览器并查看插件的功能。
INFO: Jenkins is fully up and running
在 Jenkins 中创建一个自由风格的任务,然后给它取个名字。 然后添加 "Say hello world" 构建步骤,如下图所示:
输入一个名字,如:Jenkins ,然后保存该任务, 点击构建,查看构建日志,输出如下所示:
Started by user anonymous Building in workspace /Users/mrjenkins/demo/work/workspace/testjob Hello, Jenkins! Finished: SUCCESS
定制开发插件
Jenkins 插件开发归功于有一系列扩展点。 开发人员可以对其进行扩展自定义实现一些功能。
这里有几个重要的概念需要做下说明:
扩展点( ExtensitonPoint )
扩展点是 Jenkins 系统某个方面的接口或抽象类。 这些接口定义了需要实现的方法,而 Jenkins 插件需要实现这些方法。
笔者所写的插件需要实现 Builder 这个扩展点。 代码片段如下:
public class MavenCheck extends Builder {}
Descriptor 静态内部类
Descriptor 静态内部类是一个类的描述者,用于指明这是一个扩展点的实现, Jenkins 通过这个描述者才能知道我们写的插件。 每一个描述者静态类都需要被 @Extension 注解, Jenkins 内部会扫描 @Extenstion 注解来获取注册了哪些插件。
代码片段如下:
@Extension public static final class DescriptorImpl extends BuildStepDescriptor<Builder> { public DescriptorImpl() { load(); } @Override public boolean isApplicable(Class<? extends AbstractProject> aClass) { return true; } @Override public String getDisplayName() { return "Maven SNAPSHOT Check"; } }
在 DesciptorImpl 实现类中有两个方法需要我们必须要进行重写: isApplicable() 和 getDisplayName() 。 isApplicable() 这个方法的返回值代表这个 Builder 在 Jenkins Project 中是否可用, 我们可以将我们的逻辑写在其中,例如做一些参数校验, 最后返回 true 或 false 来决定这个 Builder 是否可用。
getDisplayName() 这个方法返回的是一个 String 类型的值, 这个名称被用来在 web 界面上显示。
数据绑定
前端页面的数据要和后台服务端进行交互,需要进行数据绑定。 前端 config.jelly
页面代码片段如下:
<?jelly escape-by-default='true'?> <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"> <f:entry title="check" field="check"> <f:checkbox /> </f:entry> </j:jelly>
如上所示,需要在 config.jelly 中包含需要传入的参数配置信息的选择框,field 为 check ,这样可以在 Jenkins 进行配置,然后通过 DataBoundConstructor 数据绑定的方式,将参数传递到 Java 代码中。 服务端 Java 代码片段如下:
@DataBoundConstructor public MavenCheck(boolean check) { this.check = check; }
核心逻辑
笔者所写的插件的核心逻辑是检查 Maven pom.xml 文件是否包含 SNAPSHOT 版本依赖。
Jenkins 是 Master/Agent 架构, 这就需要读取 Agent 节点的 workspace 的文件, 这是笔者在写插件时遇到的一个难点。
Jenkins 强大之处在于它的生态,目前有上千个插件, 笔者参考了 Text-finder Plugin 的源码, 并在参考处添加了相关注释,最终实现了插件要实现的功能。
详细代码可以查看 jenkinsci/maven-snapshot-check-plugin 代码仓库。
分发插件
使用 mvn package
命令可以打包出后缀为 hpi 的二进制包, 这样就可以分发插件,将其安装到 Jenkins 实例。
插件使用说明
以下是对插件的使用简要描述。
如果勾选了下面截图中的选择框, Jenkins 任务在构建时将会检查 pom.xml 中是否包含 SNAPSHOT 。
如果检查到的话,则会将该次构建状态标记为失败。
总结
文章上篇主要介绍了从产生 idea 到插件开发完成的过程。
那么插件在开发完成后是如何将它托管到 Jenkins 插件更新中心让所有用户都可以看到的呢?
两天后的文章下篇将对这个过程进行介绍,敬请期待!
参考
作者:王冬辉
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
Java的并发编程中的多线程问题到底是怎么回事儿?
在我之前的一篇《再有人问你Java内存模型是什么,就把这篇文章发给他。》文章中,介绍了Java内存模型,通过这篇文章,大家应该都知道了Java内存模型的概念以及作用,这篇文章中谈到,在Java并发编程中,通常会遇到三个问题,即原子性问题、一致性问题和有序性问题。 上面一篇文章简单介绍了一下,由于各种原因会导致多线程场景下可能存在原子性、一致性和有序性问题。但是并没有深入,这篇文章就来在之前的基础上,再来看一下,并发编程中,这些问题都是哪来的? 首先,我们还是从操作系统开始,先来了解一些基础知识。 CPU时间片 很多人都知道,现在我们用到操作系统,无论是Windows、Linux还是MacOS等其实都是多用户多任务分时操作系统。使用这些操作系统的“用户”是可以“同时”干多件事的,这已经是日常习惯了,并没觉得有什么特别。 但是实际上,对于单CPU的计算机来说,在CPU中,同一时间是只能干一件事儿的。 为了看起来像是“同时干多件事”,分时操作系统是把CPU的时间划分成长短基本相同的时间区间,即”时间片”,通过操作系统的管理,把这些时间片依次轮流地分配给各个“用户”使用。 如果某个“用户”在时...
- 下一篇
死磕 java并发包之AtomicInteger源码分析
问题 (1)什么是原子操作? (2)原子操作和数据库的ACID有啥关系? (3)AtomicInteger是怎么实现原子操作的? (4)AtomicInteger是有什么缺点? 简介 AtomicInteger是java并发包下面提供的原子类,主要操作的是int类型的整型,通过调用底层Unsafe的CAS等方法实现原子操作。 还记得Unsafe吗?点击链接直达【死磕 java魔法类之Unsafe解析】 原子操作 原子操作是指不会被线程调度机制打断的操作,这种操作一旦开始,就一直运行到结束,中间不会有任何线程上下文切换。 原子操作可以是一个步骤,也可以是多个操作步骤,但是其顺序不可以被打乱,也不可以被切割而只执行其中的一部分,将整个操作视作一个整体是原子性的核心特征。 我们这里说的原子操作与数据库ACID中的原子性,笔者认为最大区别在于,数据库中的原子性主要运用在事务中,一个事务之内的所有更新操作要么都成功,要么都失败,事务是有回滚机制的,而我们这里说的原子操作是没有回滚的,这是最大的区别。 源码分析 主要属性 // 获取Unsafe的实例 private static final Un...
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
推荐阅读
最新文章
- Eclipse初始化配置,告别卡顿、闪退、编译时间过长
- SpringBoot2初体验,简单认识spring boot2并且搭建基础工程
- Red5直播服务器,属于Java语言的直播服务器
- Docker安装Oracle12C,快速搭建Oracle学习环境
- SpringBoot2配置默认Tomcat设置,开启更多高级功能
- Windows10,CentOS7,CentOS8安装MongoDB4.0.16
- CentOS7编译安装Gcc9.2.0,解决mysql等软件编译问题
- Mario游戏-低调大师作品
- SpringBoot2整合Redis,开启缓存,提高访问速度
- SpringBoot2整合Thymeleaf,官方推荐html解决方案