jenkinsciinfra/plugin-site-api

Plugin Site Api 镜像文档

概述

Plugin Site Api镜像是Jenkins基础设施项目（https://github.com/jenkins-infra/plugin-site-api/%EF%BC%89%E7%9A%84Docker%E5%8C%96%E9%83%A8%E7%BD%B2%E5%BD%A2%E5%BC%8F%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8E%E6%8F%90%E4%BE%9BJenkins%E6%8F%92%E4%BB%B6%E7%9A%84API%E6%9C%8D%E5%8A%A1%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E4%BD%9C%E4%B8%BAJenkins%E6%8F%92%E4%BB%B6%E7%94%9F%E6%80%81%E7%B3%BB%E7%BB%9F%E7%9A%84%E6%A0%B8%E5%BF%83%E7%BB%84%E4%BB%B6%EF%BC%8C%E6%94%AF%E6%92%91%E6%8F%92%E4%BB%B6%E4%BF%A1%E6%81%AF%E6%9F%A5%E8%AF%A2%E3%80%81%E7%89%88%E6%9C%AC%E7%AE%A1%E7%90%86%E3%80%81%E4%BE%9D%E8%B5%96%E5%85%B3%E7%B3%BB%E8%A7%A3%E6%9E%90%E7%AD%89%E5%85%B3%E9%94%AE%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%98%AFJenkins%E6%8F%92%E4%BB%B6%E7%AB%99%E7%82%B9%E5%8F%8A%E7%9B%B8%E5%85%B3%E5%B7%A5%E5%85%B7%E7%9A%84%E5%90%8E%E7%AB%AF%E6%9C%8D%E5%8A%A1%E5%9F%BA%E7%A1%80%E3%80%82

核心功能和特性

核心功能

• 插件元数据查询：提供API接口获取插件基本信息（名称、描述、开发者、许可证等）
• 版本管理：支持插件多版本信息检索，包括版本号、发布日期、兼容性说明
• 依赖关系解析：返回插件间的依赖关系（前置依赖、冲突插件等）
• 下载链接生成：提供插件各版本的直接下载URL

特性

• 高性能缓存：内置数据缓存机制，减少重复查询开销，提升API响应速度
• 标准化接口：遵循RESTful API设计规范，接口文档可通过Swagger/OpenAPI访问
• 可扩展性：支持通过配置文件扩展数据来源或集成额外插件仓库
• 健康检查：内置健康检查接口，便于容器编排平台（如Kubernetes）监控服务状态

使用场景和适用范围

适用场景

• Jenkins插件站点后端：作为Jenkins官方插件站点（plugins.jenkins.io）的后端服务
• 第三方插件工具开发：为插件管理工具、IDE插件、CI/CD流水线工具提供数据支持
• 插件生态分析：支持插件使用情况统计、依赖关系图谱构建等分析场景
• 私有插件仓库：适配企业内部私有Jenkins插件仓库的API服务需求

适用人群

• Jenkins基础设施维护人员
• Jenkins插件开发者（需查询插件生态数据时）
• 企业DevOps团队（搭建私有插件管理系统）

使用方法和配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name plugin-site-api \
  -p 8080:8080 \
  jenkins-infra/plugin-site-api:latest

服务启动后，可通过 http://localhost:8080 访问API，接口文档通常位于 /swagger-ui.html 路径（需根据具体版本确认）。

环境变量配置

示例（自定义缓存时间和日志级别）：

bash
docker run -d \
  --name plugin-site-api \
  -p 8080:8080 \
  -e CACHE_TTL=1800 \
  -e LOG_LEVEL=DEBUG \
  jenkins-infra/plugin-site-api:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  plugin-site-api:
    image: jenkins-infra/plugin-site-api:latest
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - CACHE_TTL=3600
      - LOG_LEVEL=INFO
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/actuator/health"]
      interval: 30s
      timeout: 10s
      retries: 3

数据持久化（可选）

若需持久化缓存数据（如使用外部数据库），可通过 DB_CONNECTION_STRING 环境变量配置数据库连接（支持PostgreSQL、MySQL等主流数据库）。具体配置需参考项目GitHub文档中关于数据库适配的说明。

注意事项

• 镜像版本需与Jenkins插件仓库版本兼容，建议使用官方推荐的版本搭配
• 生产环境中建议配置外部缓存（如Redis）或数据库，避免容器重启后缓存丢失
• 高并发场景下需调整JVM参数（通过 -e JAVA_OPTS="-Xmx1g -Xms512m" 等）优化性能