Jenkins 插件

与 Jenkins CI/CD 集成——触发构建、查看日志、监控状态。

概述

Jenkins 插件让 AI 员工可以在对话中管理 Jenkins 构建,包括触发构建、查看构建状态和日志等。

工具列表

工具名功能说明
jenkins_manage_instance管理 Jenkins 实例添加/编辑/删除 Jenkins 服务器连接
jenkins_list_jobs列出 Job查看可用的构建任务列表
jenkins_job_infoJob 详情查看配置信息和最近构建记录
jenkins_trigger_build触发构建执行构建任务,支持参数化构建
jenkins_build_status构建状态查询指定构建的当前状态
jenkins_build_log构建日志查看构建的控制台输出
jenkins_system_info系统信息查看 Jenkins 版本、节点状态等

配置

添加 Jenkins 实例

在 Web 管理面板的插件配置中添加,或通过对话让 AI 员工配置:

用户: 帮我连一下我们的 Jenkins

AI: 好的,需要以下信息:
  1. Jenkins 地址(如 http://jenkins.example.com:8080)
  2. 用户名
  3. API Token(在 Jenkins → 用户设置 → API Token 中生成)

用户: 地址是 http://192.168.1.100:8080,用户 admin,Token 是 xxx

AI: 连接成功。Jenkins 版本 2.426,共有 12 个 Job。

获取 API Token

  1. 登录 Jenkins → 点击右上角用户名
  2. 进入 ConfigureAPI Token
  3. 点击 Add new Token → 复制生成的 Token

使用示例

触发构建

用户: 帮我跑一下 frontend-build 的构建

AI: 确认一下:要触发 Job「frontend-build」的构建吗?
  上次构建 #42 状态:成功(2 小时前)

        [确认构建]    [取消]

用户: 确认

AI: 构建 #43 已触发,正在排队中...
  构建开始了,预计 3 分钟完成。完成后我通知你。

查看构建日志

用户: 刚才那个构建怎么样了?

AI: 构建 #43 已完成,状态:失败。
  关键错误:
  > npm ERR! peer dep missing: react@^18.0.0
  看起来是依赖版本不匹配。要我看看详细日志吗?

安全说明

  • 触发构建操作有二次确认机制,防止误操作
  • Jenkins API Token 加密存储在 OpenVort 数据库中
  • 建议为 AI 使用的 Jenkins 账号设置适当权限,避免使用管理员账号