Skip to content

Releases: AlexWuYh/jenkins-build-archive

v1.4.0 — Jenkins Build Archive

Choose a tag to compare

@AlexWuYh AlexWuYh released this 28 Oct 03:44

概述

Jenkins Build Archive 首个正式版本。这是一个独立于 Jenkins 的构建元数据归档服务,在 Build Record 被清理后,仍可追溯 Git 分支 / Commit、Docker Image Tag / Digest 等信息。面向内网部署,开箱即用(Docker Compose)。

✨ 新特性

  • 归档写入:支持 Jenkins HTTP API 与 Shared Library 接入;以 (jobName, buildId) 保证幂等,归档失败不影响 Jenkins 构建结果
  • 查询与展示:Web UI 与 REST API;支持按 Job / 分支 / Commit / Tag 搜索筛选,列表带序号,默认展示当日构建,/?all=1 查看全部历史
  • Commit 详情:归档 commitMsg / commitAuthor / commitId / commitFiles,详情页新增「Commit 详情」卡片;Commit SHA 与 gitCommit 互相回填,统一展示
  • 管理能力:管理密码保护的单条 / 批量删除;支持最长保留天数、每 Job 上限等保留策略
  • 大数据量优化:分页大小可选(20 / 50 / 100),Job 下拉有界,补充索引与 SQLite PRAGMA 调优

🔒 安全

  • 写接口使用 API_TOKEN,Web 管理使用 ADMIN_PASSWORD;未配置或使用默认占位值时 fail-closed(503)
  • Shared Library 通过环境变量与文件传递 payload,避免 token 拼接进 shell 字符串
  • 页面与静态资源不嵌入任何凭据

🐛 问题修复

  • 修复 dateTo 为当天时漏掉当日构建的边界问题
  • 修复 currentBuild.duration 未设置时构建耗时丢失
  • 修复 gitCommit 占位符 - 被当作有效值的问题,回退使用 commitId
  • 修复「全部历史」翻页后丢失范围,并将分页移至结果栏同行
  • 安全拆分内嵌 commitFiles,优化 Files 展示

🚀 部署

cp .env.example .env   # 修改 API_TOKEN 与 ADMIN_PASSWORD
docker compose up -d --build
curl http://127.0.0.1:8080/health

完整说明见 README。

📦 发布资产

文件 说明
jenkins-build-archive-v1.4.0.zip 源码包(由 GitHub Actions 自动构建)
jenkins-build-archive-v1.4.0.zip.sha256 SHA-256 校验文件

校验方式:sha256sum -c jenkins-build-archive-v1.4.0.zip.sha256


Full Changelog: https://github.com/AlexWuYh/jenkins-build-archive/commits/v1.4.0