本插件通过 Remote Access API 来收集 Jenkins 数据。然后根据收集到的原始数据,计算并展示相关的 devops 指标。
指标名称 | 说明 |
---|---|
构建数量 | 创建的构建数量 |
构建成功率 | 成功构建的百分比 |
在使用本插件之前,您需要先在 config-ui
上面对插件进行配置。
为了能访问到 Jenkins 的 API ,请确保完成以下的必填设置项。目前 Jenkins 只支持单一数据源,列表只会显示一个连接,同时其名称是固定不可修改的。多数据源支持会在不久的将来实现。
- Connection Name [只读]
⚠️ D默认为 "Jenkins" 且不能修改。
- Endpoint URL (REST URL, 必须以
https://
或http://
开头,/
结尾)- 必须指向一个有效的 REST API 端点, 比如
https://jenkins.example.com/
- 必须指向一个有效的 REST API 端点, 比如
- Username (E-mail)
- 该 Jenkins 实例上的有效用户名。
- Password (密码或 API 的 Acess Token)
- 用户名对应的密码
- 请参照 Jenkins 的官方文档中关于 "Using Credentials" 的说明
- 您可以使用 API Access Token 代替密码, 可在 Jenkins 的面板中依次打开
User
->Configure
->API Token
进行生成。
完成上述项目设定后,请点击保存按钮更新连接的设置。
为了触发插件进行数据收集和计算,您需要构造一个 JSON, 通过 config-ui
中的 Triggers
功能,发送请求触发收集计算任务:
[
[
{
"plugin": "jenkins",
"options": {}
}
]
]