在 CentOS 6.5 上使用 ansible 的 jenkins_job 模块

运行环境

• CentOS 6.5
• ansible 2.6.8
• 系统自带python2.6
• 用户为 root

问题/解决

最近试用了一下 ansible 的 jenkins_job 模块，在这里整理一下我遇到的问题和解决方法。

首先是模块的官方文档 https://docs.ansible.com/ansi...

根据官方文档，须要运行 jenkins_job 的目标机器须要安装2个依赖，分别是：

• python-jenkins >= 0.4.12
• lxml >= 3.3.3

首先说 lxml ，若是直接使用系统默认 python 的 pip 安装，安装过程当中会报错:

error: command 'gcc' failed with exit status 1

在网络上查询通常的解决办法都会告知须要安装 libxml2 和 libxslt 的开发套件，也就是

yum install -y libxml2-devel libxslt-devel

可是若是你的系统是新的系统或者很是的“干净”的话，你会发现安装完成以后仍然不能 pip install lxml ，这时还须要安装 python-devel

yum install -y python-devel

安装完成以后就能够正常使用 pip 安装 lxml 了

pip install lxml

下面说 python-jenkins ，直接使用 pip 安装上 python-jenkins 后并不能使用，调用 ansible 的 jenkins_job 模块或者直接在目标主机上的 python 中 import jenkins 会报语法错误，像这样：

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/lib/python2.6/site-packages/jenkins/__init__.py", line 59, in <module>
    import requests
  File "/usr/lib/python2.6/site-packages/requests/__init__.py", line 43, in <module>
    import urllib3
  File "/usr/lib/python2.6/site-packages/urllib3/__init__.py", line 8, in <module>
    from .connectionpool import (
  File "/usr/lib/python2.6/site-packages/urllib3/connectionpool.py", line 92
    _blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK}
                                    ^
SyntaxError: invalid syntax

在网络上查询到报错的缘由是 python-jenkins 最新版本并不支持 python2.6 ，解决方法就是安装旧版本的 python-jenkins ，这里就选 jenkins_job 要求的最低版本 0.4.12 就好：

pip uninstall python-jenkins
pip install python-jenkins==0.4.12

这时再在目标主机的 python 中 import jenkins 不会报语法错误了，只会提示一个 "UserWarning: Support for python 2.6 is deprecated and will be removed." 即将再也不支持 python2.6 ，这个版本能支持那么就一直使用这个版本好了。

使用方法

解决了 jenkins_job 模块的问题使之能够调用了以后，下面咱们来看看如何使用这个模块。根据官网文档的描述，可使用这个模块对 jenkins 的 job 进行 建立/删除/禁用/启用 的操做，认证方式可使用 jenkins 的用户名加密码/token 的方式。下面放个简单的例子用于禁用某项目：

---
- hosts: localhost
  gather_facts: no
  vars:
  tasks:
  - name: "disable jenkins job"
    jenkins_job:
      url: http://you.jenkins.domainname:port
      user: yourusername
      password: yourpassword
      name: "jenkins_job_name"
      enabled: False

启用/禁用/删除 和选择密码仍是 token 登陆都很是好理解，下面看一下官方建立项目的例子：

# Create a jenkins job using basic authentication
- jenkins_job:
    config: "{{ lookup('file', 'templates/test.xml') }}"
    name: test
    password: admin
    url: http://localhost:8080
    user: admin

其余字段都很是好理解，只有 config 字段是得到了 templates/test.xml 这个文件的内容，而对于这个文件里的内容，并无更多的解释。这部分应该属于 jenkins 定义的范围。不知道是不多人使用仍是我搜索的方法不对，我并无很容易的找到关于这个 xml 文件怎么定义的文档，可是我查到其实这个 xml 就是你的 jenkins 目录下的 jobs/yourJobName/config.xml 。因此最简单的方法就是在 jenkins 上建立好须要的 job 而后复制出这个 config.xml 文件，这样你就获得了你须要的 config 字段中的内容，也能够在其中修改一些值，改一个现有的配置文件总比从零开始写要容易。

config 字段除了使用 "{{ lookup('file','xxxx.xml') }}" 的形式以外，还可使用 "{{ lookup('template', 'xxxx.xml.j2') }}" 将 xml 文件改为 jinja2 模板，这样就可使用 ansible 的变量动态生成 job 了。