jenkinsciinfra/plugin-health-scoring

Jenkins插件健康评分系统Docker镜像

概述

Jenkins插件健康评分系统Docker镜像提供了一个便捷的方式来部署和运行Jenkins插件健康评分工具。该系统是2022年Google Summer of Code (GSOC)项目的一部分，旨在通过自动化评估插件质量和健康状况，提升Jenkins生态系统的整体质量。

核心功能

• 自动化评估Jenkins插件的健康状态
• 基于多维度指标对插件进行评分
• 生成详细的插件健康报告
• 支持批量评估多个插件
• 提供历史评分追踪功能
• 可集成到CI/CD流程中

使用场景

• Jenkins插件开发者评估自己的插件质量
• Jenkins管理员评估已安装插件的健康状况
• Jenkins生态系统维护者监控社区插件质量
• 插件审核流程中的自动化质量检查
• 定期监控关键插件的健康状态变化

快速开始

基本使用

bash
docker run -it jenkins-infra/plugin-health-scoring:latest

指定评估单个插件

bash
docker run -it jenkins-infra/plugin-health-scoring:latest --plugin <plugin-id>

生成HTML报告

bash
docker run -v $(pwd):/reports -it jenkins-infra/plugin-health-scoring:latest --plugin <plugin-id> --format html --output /reports/health-report.html

配置参数

命令行参数

环境变量

Docker Compose配置

yaml
version: '3'
services:
  plugin-health-scoring:
    image: jenkins-infra/plugin-health-scoring:latest
    volumes:
      - ./reports:/reports
      - ./config:/config
    environment:
      - PLUGIN_HEALTH_DB_URL=jdbc:h2:/data/plugin-health
      - PLUGIN_HEALTH_CACHE_TTL=86400
    command: --config /config/config.yaml --output /reports/weekly-report.html

高级配置

自定义评分规则

可以通过挂载自定义配置文件来修改评分规则:

bash
docker run -v $(pwd)/custom-rules.yaml:/config.yaml -it jenkins-infra/plugin-health-scoring:latest --config /config.yaml --plugin my-plugin

配置文件格式详情请参见项目GitHub仓库文档。

数据持久化

为了保存评分历史数据，建议挂载数据卷:

bash
docker run -v plugin-health-data:/app/data -it jenkins-infra/plugin-health-scoring:latest

集成到CI/CD

在CI/CD流程中使用插件健康评分:

bash
docker run --rm -v $(pwd):/workspace jenkins-infra/plugin-health-scoring:latest \
  --plugin my-plugin \
  --format json \
  --output /workspace/plugin-health-report.json
  
# 检查评分是否达到最低要求
python -c "import json; report = json.load(open('plugin-health-report.json')); exit(1) if report['score'] < 70 else exit(0)"

更多信息

• 项目GitHub仓库: https://github.com/jenkins-infra/plugin-health-scoring
• 官方文档: [***]
• 问题反馈: https://github.com/jenkins-infra/plugin-health-scoring/issues