在研究jenkinsapi的时候，在百度和google查找资料，总是些零零碎碎的介绍，基于这段时间的研究，有点小成就，所以将研究的工作记录下来。

jenkinsapi库的安装

  1. 下载：在https://pypi.python.org/pypi/jenkinsapi/上下载jenkinsapi-0.2.26.tar.gz；

  2. 安装：解压jenkinsapi-0.2.26.tar.gz，进入jenkinsapi-0.2.26目录，运行pythonsetup.py install 进行安装，联网情况下，程序会直接下载一些包，并进行安装，运行结束后可以对该库进行操作。


jenkinsapi库封装的类

该库下封装了23个类，主要有jenkins.py、job.py、build.py、view.py、node.py等，其主要作用：

1.jenkins.py

   主要通过该接口进入jenkins服务器，对job、node进行操作，有：

get_jobs、create_job、build_job、delete_job、get_node、get_queue、get_plugins、get_master_data等；

2.job.py

   针对job的构建进行操作，有：

get_first_buildnumber、get_last_stable_buildnumber、get_last_failed_buildnumber、get_next_build_number、is_queued、is_running、is_enabled、delete_from_queue等；

3.build.py

   对构建的job的构建结果进行分析有：

get_number、get_status、get_revision_branch、get_master_job_name、get_master_build_number等；

4.view.py

对view视图进行操作

5.node.py

对node节点进行操作


jenkinsapi库的使用

获得jenkins中job的列表

代码为：

# -*- coding: gb2312 -*-
"""
输入：jenkins服务器的地址，用户名和密码
输出：已定义的job的列表
"""
import datetime, time
from jenkinsapi.jenkins import *
from jenkinsapi.job import *
from jenkinsapi.build import Build
def Url_Get_Job_List(url='http://localhost:8080', username='jenkins', password='jenkins'):
    jenkins = Jenkins(url, username, password)
    count = 0
    for job_name in jenkins.keys():
        my_job = jenkins.get_job(job_name)
        count = count + 1
        print "Job" + str(count) + " : "+job_name
if __name__ == "__main__":
    Url_Get_Job_List()


运行后输出：

Job1 : create

Job2 : JenkinsTest

Job3 : Test_1



根据给定job名获得job的构建情况

代码：

# -*- coding: cp936 -*-
"""
输入：jenkins job名称和日期(年、年-月、年-月-日)
输出：job的名称、日期、执行次数、成功次数、失败次数、未执行次数、不稳定次数
"""
import datetime, time
from jenkinsapi.jenkins import *
from jenkinsapi.job import *
from jenkinsapi.build import Build
def Get_Date_List(Job_Name):
    my_job = jenkins.get_job(Job_Name)
    first_build = my_job.get_first_buildnumber()      #获得jenkins列表中的第一个构建数目，不一定是从1开始的
    last_build = my_job.get_last_buildnumber()      #获得最近一次构建的数目
        
    for count in xrange(first_build, last_build+1):    #依次获得每一个job号
        count_build = my_job.get_build(count)
        start_time =  count_build.get_timestamp()      #获得构建时间，时区好像不大对
        
        adjust_time = start_time + datetime.timedelta(hours=8)   #所以在这里加了8小时，变成北京时间了
        Build_Time = adjust_time.strftime("%Y-%m-%d")     #输出时间的格式
        Status =count_build.get_status()                 #返回这次构建的状态，成功或失败
        
        print my_job, count, Build_Time, Status
                              
    
if __name__ == "__main__":
    jenkins = Jenkins('http://localhost:8080', 'jenkins', 'jenkins')
    Job_Name = 'create' 
    Get_Date_List(Job_Name)



运行结果如下：

create 1 2015-03-24 FAILURE

create 2 2015-03-24 FAILURE

create 3 2015-03-24 SUCCESS

create 4 2015-03-25 SUCCESS

create 5 2015-03-30 FAILURE


通过该模块，运行脚本能够得到jenkins每天的构建的详细信息，方便每天的统计。

本人接触python时间不长，研究也比较肤浅，希望能够和大家一起学习，欢迎一起讨论！