jk

Jenkins 命令行

使用 jk 读取和更改 Jenkins。语法不确定时，请查看 jk --help 或子命令的帮助信息。仅当命令不可用或请求的功能有已知的最低版本要求时，才检查安装情况或版本。

路由任务

只阅读与请求匹配的规则：

• 身份验证和 SSO：rules/auth.md
• 已保存的控制器和上下文选择：rules/context.md
• 作业、文件夹、配置和扫描：rules/job.md
• 运行、参数、重新运行和日志：rules/run.md
• 构件：rules/artifact.md
• 测试报告：rules/test.md
• 凭据：rules/cred.md
• 节点：rules/node.md
• 队列：rules/queue.md
• 插件：rules/plugin.md
• 其他管理命令：rules/other.md

要查看确切的标志和输出模式，请在 references/commands.md 中搜索相应子命令。

通用操作规则

• 除非用户指定其他控制器，否则使用当前活动上下文。在执行会更改状态或涉及安全敏感内容的操作前，确认目标上下文。
• 如果其他工具或脚本会使用结果，优先采用结构化输出（--json 或 --yaml）。
• 启动带参数的运行前，先检查作业声明的参数；不要猜测参数名称或取值。
• 将作业配置、凭据、节点、插件、取消队列任务和删除运行视为会更改状态的操作。展示解析后的目标，并遵循用户的授权。
• 绝不打印、存储或回显 Jenkins 令牌或凭据机密。浏览器 SSO 访问令牌不是 Jenkins API 令牌；请遵循 rules/auth.md。
• 除非用户明确选择承担该风险，否则不要降低 TLS 验证强度。

常见读取操作

jk job ls
jk job view team/app
jk run ls team/app
jk run view team/app 128
jk log team/app 128 --follow
jk artifact ls team/app 128
jk test report team/app 128
jk queue ls

编写写入命令前，请先阅读相关规则文件。

参考资料

• artifact — 使用运行构件
• auth — 对 Jenkins 实例进行身份验证
• context — 管理 Jenkins 上下文
• cred — 管理 Jenkins 凭据
• job — 管理 Jenkins 作业和流水线
• node — 检查和管理 Jenkins 节点
• plugin — 检查和管理 Jenkins 插件
• queue — 检查构建队列
• run — 与作业运行交互
• test — 检查测试结果
• other — 日志、搜索、版本