jenks 0.2.3

安装

• 由于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文件来配置自己。Jenks在当前目录中搜索，并在找到之前向上移动父目录。

.jenksrc文件应该是一个yaml文件，包含主机和配置的一些键的字典。

以下是一个包含所有选项的.jenksrc文件示例

'localhost':
  url: 'https://:8080/'
  jobs:
    - foo
    - bar
'http://jenkins.local':
  jobs:
    - baz

主机的深入配置是

• url：到主机的url。如果url不存在，则使用主机名作为url

• jobs：要添加到列表中的作业名称列表

键

默认情况下，Jenks将在配置中的所有作业上执行操作。但是，您可以通过传递键的列表来限制作业为特定的几个。每个作业都由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哲学，即做一件事并做好。通过成为模块化部分并支持stdin，可以将Jenks与其他命令链式使用。

例如，以下是一个仅列出与特定正则表达式匹配的主机或工作名称的工作状态的命令

$ jenks -l | grep "foo" | cut -d ' ' -f 1 | jenks
0: localhost, foo (last build #7) SUCCESS

监控您的Jenkins工作状态

$ watch jenks