要查找特定类型的 Jenkins 任务,可以通过过滤对应字段的值来实现。下面,给出一个查找参数化任务的例子:
jcli job search --filter Parameterized=true
其中 --filter
支持任意字段,它是以是否包含指定字符串进行判断的。
构建
要触发一个任务的话,可以使用下面的命令:
jcli job build "jobName" -b
当你需要触发任务构建,并等待对应任务的构建号的话,可以使用下面的命令 (依赖插件):
jcli job build job/test -b --wait
交互式输入
运行上面的流水线后,执行到 input
位置就会阻塞并等待输入,此时可以通过命令 来使得继续执行或者中断。
目前,只对以脚本的形式保存在 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 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 所支持的任务类型