搜索

使用如下的命令可以搜索 Jenkins 任务：

jcli job search input

要查找特定类型的 Jenkins 任务，可以通过过滤对应字段的值来实现。下面，给出一个查找参数化任务的例子：

jcli job search --filter Parameterized=true

其中 --filter 支持任意字段，它是以是否包含指定字符串进行判断的。

构建

要触发一个任务的话，可以使用下面的命令：

jcli job build "jobName" -b

当你需要触发任务构建，并等待对应任务的构建号的话，可以使用下面的命令 （依赖插件pipeline-restful-api-plugin）：

jcli job build job/test -b --wait

交互式输入

执行到 Jenkins 流水线中的 input 指令时，会有交互式输入的提示。下面是一个样例：

pipeline {
    agent {
        label 'master'
    }
    stages {
        stage('sample') {
            steps {
                input 'test'
            }
        }
    }
}

运行上面的流水线后，执行到 input 位置就会阻塞并等待输入，此时可以通过命令 jcli job input test 1 来使得继续执行或者中断。

编辑

目前，只对以脚本的形式保存在 Jenkins 上的流水线有编辑功能的支持。命令非常简单：jcli job edit test

如果希望能快速地给出一个流水线的样例的话，当在流水线脚本为空时，可以执行命令：jcli job edit test --sample

如果希望编辑流水线并保存退出后，直接触发的话，可以使用对应的参数来实现：jcli job edit test --build

禁用

禁用任务：jcli job disable job/test/

启用任务：jcli job enable job/test/

查看日志

通过下面的命令可以参考一个任务的执行日志：

jcli job log "jobName" -w

查看历史

jcli job history job/test/

归档文件

查看归档文件列表 jcli job artifact job/test/

下载归档文件 job artifact download /job/tsf/job/ddd/

显示指定列

当以表格形式输出，希望能输出指定的字段为列时，我们可以通过下面的方式实现：

jcli job search --columns Name,URL,Parameterized

请注意，上面的参数 --columns 的值是以英文逗号（,）为分割的。

如果不希望输出表头，可以增加参数：--no-headers

jcli job search --columns Name,URL,Parameterized --no-headers

任务类型

列出当前 Jenkins 所支持的任务类型 jcli job type