超级实用!教大家解决jenkins插件与jenkins不兼容的问题
问题描述如下目前公司的Jenkins 版本2.305暂时无法升级近期安装插件——这里仅以Email Extension PluginartifactId:email-ext为例遇到不兼容问题如下图所示问题原因:显然是通过jenkins自动下载的插件版本与当前的jenkins版本不兼容导致那么解决方案只有手动下载并安装兼容的历史版本思路如下第一步确认的 Jenkins 版本发布时间通过下面的链接获取Jenkins 2.305 发布时间大概为2021-07-22https://get.jenkins.io/war/这意味着应该优先考虑 2021 年中之前或稍后发布的Email Extension Plugin插件版本第二步查找插件的发布历史和兼容性访问插件官网打开插件主页https://plugins.jenkins.io/email-ext/releases/滚动到符合标准的历史版本例如2.83用压缩工具如 7-Zip打开.hpi文件。查看META-INF/MANIFEST.MF文件内容找到信息如下Jenkins-Version: 2.222.4这个值 ≤ 2.305证明兼容。第三步下载对应版本的 .hpi 文件直接下载插件email-ext https://updates.jenkins-ci.org/download/plugins/email-ext/第四步手动上传安装插件登录 Jenkins进入 Manage Jenkins Manage Plugins切换到 “Advanced” 标签页在 “Upload Plugin” 区域选择你下载的.hpi文件点击 Upload安装完成后根据提示 重启 Jenkins如果提示缺少依赖插件获取与其他插件不兼容同样需要手动下载对应历史版本安装。自动化建议批量处理如果你经常需要为旧版 Jenkins 安装插件可以建立本地插件仓库把已验证兼容的.hpi文件存档使用 Jenkins CLI 或脚本批量安装1java -jar jenkins-cli.jar -s http://your-jenkins/ install-plugin /path/to/email-ext.hpi总结流程通用模板步骤操作1️⃣确认 Jenkins 版本及发布时间2️⃣查找目标插件的 GitHub Releases 或 plugin site3️⃣找到满足Minimum-Jenkins-Version ≤ 你的版本的最高插件版本4️⃣从updates.jenkins-ci.org下载对应.hpi5️⃣在 Jenkins “Advanced” 页面手动上传安装6️⃣处理依赖插件重复上述过程