在该系统中,Jenkins负责定时检测代码库(Code Repository
)的代码更新情况,当检测到有新的代码提交时,自动采用最新的代码进行构建,并采用构建得到的包(apk)触发自动化测试平台(DroidTestbed
)执行测试任务。
然后再说下分支管理模块。
由于我们的持续集成平台通常不止监控一个产品,而每个产品又不止监控一个tag(例如/trunk,/projects/cn/10.9.8),因此,我们的持续集成平台需要有分支管理的功能,即针对每一个产品的每一个tag,单独创建一个分支,并针对各个分支单独指定测试用例集合测试设备。
具体实现方面,出于单一职责的原则,我们对功能进行了如下划分:
- 在Jenkins端针对每一个分支创建一个Job;
- 在
DroidTestbed
端配置测试资源,针对每一个分支分别绑定测试用例集和测试设备,每一个分支会存在一个单独的branch_id; - 在Jenkins端的Job配置中,保存该分支在
DroidTestbed
中对应的branch_id
,实现Jenkins
与DroidTestbed
的关联。
整个过程看上去并没有什么问题,那为什么需要对分支管理模块进行改造呢?
问题就出现在分支配置上面。
试想一下,每次要新增或修改一个分支的时候,由于Jenkins端和DroidTestbed端的配置是独立的,那么我们就只能在两个平台上分别进行配置。
另一方面,配置工作本身也较为复杂,例如,在Jenkins端就需要设置的参数包括:repository_url,tag,ref_tag,ref_revision,branch_id,schedule,user_name等;而这其中的大部分参数同样也要在DroidTestbed端进行配置。
根据历史经验,但凡涉及到复杂且重复的手工操作时,就容易出错。实际情况的确是这样的。在该功能上线后,由于配置复杂,业务组的同学每次要新增一个监控分支时,都需要找到管理员来帮忙配置(说实话,管理员对业务同学能配置正确也没信心);即使是管理员,也出现过好几次因为疏忽造成配置错误的情况。
那么,这个问题要怎么解决呢?
Jenkins Remote API 的简介
绕了这么大一个圈子,终于引出本文的主题,Jenkins Remote API。
实际上,Jenkins本身支持丰富的API接口,我们通过远程调用接口,基本上可以实现所有需要的功能,例如:
- 从Jenkins获取Job状态信息
- 触发Jenkins执行构建
- 创建、复制、修改、删除Job
回到前面的案例,我们就可以将配置操作全部放在DroidTestbed
中,只需要在保存配置项时,由DroidTestbed
自动调用Jenkins的Remote API,即可实现配置的同步。
Jenkins Remote API 的调用
现在我们来看下如何调用Jenkins的Remote API。
Jenkins的Remote API以REST-like
的形式进行提供,通过对特定的API执行POST请求即可实现对Jenkins的操作。
例如,我们搭建的Jenkins站点为http://jenkins.debugtalk.com:8080
,那么,访问http://jenkins.debugtalk.com:8080/api
即可查看到该站点所有可用的API;若想若某个具体的Job进行操作,如job名称android_core_dashboa