job configuration history 插件可完整追踪jenkins部署配置变更，需手动安装重启后启用；修改job并保存即存档xml快照，支持查看、比对差异及一键回滚，但仅捕获web ui或兼容api触发的变更。
在 Linux 环境中运行的 Jenkins，可以通过 Job Configuration History 插件完整追踪部署配置的每一次变更——前提是插件已正确安装、启用，且变更操作确实触发了配置持久化（例如保存 Job 或系统设置）。
确认插件已安装并生效
该插件不会自动启用历史记录，必须手动安装并重启 Jenkins：
- 进入 Jenkins 管理界面 → 插件管理 → 可用插件，搜索
Job Configuration History - 勾选安装，勾选“安装后重启 Jenkins”选项（或手动重启服务：
sudo systemctl restart jenkins） - 重启后，左侧主菜单应出现 Job Config History 入口；同时每个 Job 配置页底部也会出现 Job Configuration History 链接
查看某次部署配置变更的具体内容
每次你修改 Job 的构建参数、触发器、源码分支、部署脚本路径、环境变量等，并点击“保存”，插件就会自动存档一份 XML 格式的配置快照：
- 进入具体 Job 页面 → 点击右下角的 Job Configuration History
- 列表显示所有变更时间、操作人（Jenkins 用户名）、变更类型（如
UPDATE） - 点击任意一条记录，可查看该版本的完整
config.xml内容；勾选 Show diffs 即可高亮显示与上一版本的差异（比如从master改为main分支，或新增了scp部署命令）
关联部署失败与配置变更
当某次部署突然失败，不要只查构建日志。先检查配置是否被动过：
- 打开 Job Config History 主页（非某个 Job 下），用顶部筛选器选 Job configuration，再按时间倒序排列
- 定位到失败构建前 1–2 小时内的记录，重点看是否有非你本人的操作（如其他运维人员或自动化脚本调用的 API 保存）
- 对比失败前后的两个版本：常见风险点包括 JDK 版本切换、Maven settings.xml 路径错误、SSH 凭据 ID 变更、
post-build步骤被误删等
回滚误改的部署配置
发现是配置改错导致问题，可一键恢复，无需手动编辑 XML：
- 在某条历史记录详情页，点击 Restore 按钮
- 系统会将当前 Job 的
config.xml替换为该历史版本，并自动重载配置（无需重启 Jenkins） - 注意：restore 不会覆盖构建历史或工作区文件，仅还原 Jenkins 内部任务定义
不复杂但容易忽略：插件只捕获通过 Jenkins Web UI 或兼容 API（如 /job/{name}/config.xml PUT）提交的配置变更；若你用 Jenkinsfile 声明式流水线，实际部署逻辑在 Git 里，此时应结合 Git 日志查 Jenkinsfile 修改，而非依赖此插件。
