360 Secure SkillHub
360 安全技能中心

Jenkins Executor Skill

基于 Python 与 Jenkins REST API 的 CI/CD 任务管理工具,使用 HTTP Basic Auth,读取 JENKINS_URL、JENKINS_USER、JENKINS_TOKEN 环境变量,支持列出任务、参数化触发构建、查询最新构建状态、获取控制台日志与强制停止运行中构建,并说明常见异常处理。

jack084015
jack084015
热度 58.67
最近更新 2026-05-18 12:29:39
分类:自动化依赖:代码执行 / 第三方 API应用场景:DevOps / 自动化脚本 / API 集成

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add jenkins-executor-job
Metadata
name
jenkins-executor
version
1.0.0
author
OpenClaw Developer
description
Jenkins 任务全生命周期管理工具,支持任务列表获取、远程构建、构建状态实时查询、构建日志全文获取、运行中构建强制终止,适用于 CI/CD 自动化、发布流水线、运维自动化场景。
permissions
["network:allow"]

Jenkins Executor Skill

功能完整、可直接对接 Jenkins API 进行任务管理

依赖:Python 3.x + requests 库

必须配置:JENKINS_URL、JENKINS_USER、JENKINS_TOKEN

核心功能

  1. 获取 Jenkins 任务列表

    • 列出所有任务名称、URL、是否可构建、当前状态
    • 支持分页与全量拉取
  2. 触发 Jenkins 任务构建

    • 支持参数化构建
    • 支持无参任务直接触发
    • 返回构建队列编号与构建URL
  3. 查询任务最新构建状态

    • 支持查询:构建号、状态、结果、执行时间、执行人
    • 支持 SUCCESS / FAILURE / ABORTED / BUILDING 状态
  4. 获取构建日志

    • 支持获取完整控制台日志
    • 支持增量日志与全文日志
    • 自动处理编码与换行格式
  5. 停止运行中的构建

    • 强制终止正在执行的构建
    • 支持根据任务名 + 构建号精确停止
    • 返回停止结果与状态变更

配置要求

在环境变量中配置以下信息:

  • JENKINS_URL:Jenkins 地址(例如 http://192.168.1.100:8080)
  • JENKINS_USER:Jenkins 登录用户名
  • JENKINS_TOKEN:Jenkins 用户 Token(密码也可,但不推荐)

接口说明

所有功能通过 Jenkins REST API 实现,使用 HTTP Basic Auth 鉴权,支持 Jenkins 2.250+ 所有版本。

异常处理

  • 网络不可达:返回连接失败提示
  • 鉴权失败:返回 401 未授权
  • 任务不存在:返回 404 任务不存在
  • 构建已结束:无法停止,返回状态提示