詹金斯命令行主席
jenks的Python项目详细描述
jenks是一个命令行工具,旨在与远程jenkins主机交互,包括:
首先填写配置文件,或使用以下命令添加作业:
$ jenks config -a http://localhost:8080/job/bar/
之后,您可以使用:
$ jenks 0: localhost, foo (last build #7) SUCCESS 1: localhost, bar (last build #3) SUCCESS
jenks使用分配给每个作业的唯一密钥,而不是作业 名字。您可以在上面的示例中看到它:它是 一行的开头。
您可以使用以下命令从上面触发job foo:
$ jenks trigger :0
使用以下命令从工作栏获取最新的生成信息:
$ jenks build :1
通过添加多个键同时获取有关多个作业的信息:
$ jenks -l :10
您还可以使用:
$ jenks docs
安装
- 因为jenkinsapi(主要依赖项)只是python2 兼容,jenks目前只兼容python2。
有几种安装jenks的方法。
通过PIP:
pip install jenks pip install http://github.com/toumorokoshi/jenks/tarball/master
通过sprinter:
sprinter install https://raw.github.com/toumorokoshi/jenks/master/sprinter.cfg
配置(.jenksrc)
jenks需要一个.jenksrc文件来配置自己。詹克斯搜索 当前目录并向上移动父目录,直到找到一个。
jenksrc文件应该是一个yaml文件,带有主机和 一些配置键。
下面是一个示例.jenksrc文件,包含所有选项:
'localhost': url: 'http://localhost:8080/' jobs: - foo - bar 'http://jenkins.local': jobs: - baz
主机的深入配置是:
- url:主机的url。如果URL不存在,则使用主机名作为URL
- 作业:要添加到列表中的作业名称列表
按键
默认情况下,jenks将对 配置。但是,可以通过以下方式将作业限制为特定的作业 传递密钥列表。每个作业都有一个由 詹克斯。例如,在示例配置中使用-l将产生:
$ jenks -l 0 http://jenkins.local baz 1 localhost foo 2 localhost bar
每行开头的字符是关键。每把钥匙都是 集合中的单个字符:[0-9a-za-z]。你可以把一串 以冒号为前缀的字符,以获取有关这些字符的信息:
$ jenks -l :20 0 http://jenkins.local baz 2 localhost bar
您可以将键作为:
一个论点:
$ jenks -c :0
标准输入:
$ echo '0' | jenks
作业代码
还可以使用作业按名称引用jenksrc中的作业 代码语法。作业代码语法如下:
<host_key>/<job_name> localhost/bar
例如,下面是如何按作业代码获取有关作业最新版本的信息:
$ jenks build localhost/bar
示例
jenks的目标之一是遵循unix的理念 把事情做好。作为一个模块化的部分和支持标准件, 有可能把詹克斯和其他人联系起来。
例如,下面的命令仅列出其主机或作业名称与特定regex匹配的作业的状态:
$ jenks -l | grep "foo" | cut -d ' ' -f 1 | jenks 0: localhost, foo (last build #7) SUCCESS
监视Jenkins作业的状态:
$ watch jenks