测试通过 API 远程管理 Jenkins

debugtalk · 2016年05月02日 · 4563 次阅读

背景介绍

最近接到一个需求，需要对公司内部的 Android 性能测试平台的分支管理模块进行改造。

为了更好地说明问题，在下图中展示了一个精简的持续集成测试系统。

在该系统中，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_dashboard_trunk，它的管理页面为http://jenkins.debugtalk.com:8080/job/android_core_dashboard_trunk，那么我们访问http://jenkins.debugtalk.com:8080/job/android_core_dashboard_trunk/api/即可查看到该 job 可用的 API。

更详细的 POST 调用方式的介绍可以参考 Jenkins 的官方wiki，在此就不过多进行介绍。

可以看出，通过对特定 API 执行 POST 请求操作较为原始，因为我们需要关注过多底层细节。事实上，当前已经有前辈针对这一痛点，对底层的 POST 操作细节进行了封装，形成了一些wrapper方便我们从上层进行更便捷的操作。

这类wrapper实现的功能类似，都可以方便我们在代码中通过更简洁的方式调用 Jenkins API，实现对 Jenkins 的远程管理，我们只需要根据我们采用的具体编程语言来选择对应的wrapper即可。当然，如果没有找到合适的，我们也可以参照已有的开源wrapper，自己再造一个轮子，原理都是相同的。

在 Jenkins 的官方 wiki 中，推荐了两个较为成熟的API wrapper，一个是基于 Python 实现的salimfadhley/jenkinsapi，另一个是基于 Ruby 实现的arangamani/jenkins_api_client。

以salimfadhley/jenkinsapi为例，通过使用jenkinsapi，我们在 Python 中就可以很方便地管理 Jenkins。常见的操作方式示例如下。

>>> import jenkinsapi
>>> from jenkinsapi.jenkins import Jenkins

# 指定Jenkins实例
>>> J = Jenkins('http://jenkins.debugtalk.com:8080')

# 查看Jenkins版本
>>> J.version
1.542

# 查看Jenkins的所有jobs
>>> J.keys()
['foo', 'test_jenkinsapi']

# 查看指定job的配置信息
>>> J['test_jenkinsapi'].get_config()

# 创建Jenkins job
>>> jobName = 'test_job'
>>> EMPTY_JOB_CONFIG = '''
<?xml version='1.0' encoding='UTF-8'?>
<project>
  <actions>jkkjjk</actions>
  <description></description>
  <keepDependencies>false</keepDependencies>
  <properties/>
  <scm class="hudson.scm.NullSCM"/>
  <canRoam>true</canRoam>
  <disabled>false</disabled>
  <blockBuildWhenDownstreamBuilding>false</blockBuildWhenDownstreamBuilding>
  <blockBuildWhenUpstreamBuilding>false</blockBuildWhenUpstreamBuilding>
  <triggers class="vector"/>
  <concurrentBuild>false</concurrentBuild>
  <builders/>
  <publishers/>
  <buildWrappers/>
</project>
'''
>>> new_job = J.create_job(jobName, EMPTY_JOB_CONFIG)

# 更新Jenkins job的配置
>>> import xml.etree.ElementTree as et
>>> new_conf = new_job.get_config()
>>> root = et.fromstring(new_conf.strip())
>>> builders = root.find('builders')
>>> shell = et.SubElement(builders, 'hudson.tasks.Shell')
>>> command = et.SubElement(shell, 'command')
>>> command.text = "ls"
>>> J[jobName].update_config(et.tostring(root))

# 删除Jenkins job
>>> J.delete_job(jobName)