Jenkins LTS中Timestamper与Prism API插件依赖版本冲突求助

问题场景 #

在离线环境下运行Jenkins LTS（版本2.504.2及最新版）时，Timestamper（1.30）和Prism API Plugin（1.30.0-1）插件因依赖不同版本的antisamy-markup-formatter导致加载失败，进而引发一系列间接依赖插件无法启动。当前镜像已包含antisamy-markup-formatter 173.v680e3a_b_69ff3，但Prism API要求的是162.v0e6ec0fcfcf6，冲突报错如下：

Timestamper (1.30)
    Plugin is missing: antisamy-markup-formatter (173.v680e3a_b_69ff3)

Prism API Plugin (1.30.0-1)
    Plugin is missing: antisamy-markup-formatter (162.v0e6ec0fcfcf6)

Some of the above failures also result in additional indirectly dependent plugins not being able to load.

Indirectly dependent plugins:

Coverage Plugin (2.7.1)
    Failed to load: Prism API Plugin (prism-api 1.30.0-1)
Cobertura Plugin (1.17)
    Failed to load: Code Coverage Plugin (code-coverage-api 4.99.0)
Configuration as Code Plugin (1971.vf9280461ea_89)
    Failed to load: Prism API Plugin (prism-api 1.30.0-1)
Code Coverage Plugin (4.99.0)
    Failed to load: Coverage Plugin (coverage 2.7.1)
Warnings Plugin (12.7.0)
    Failed to load: Prism API Plugin (prism-api 1.30.0-1)

解决方案 #

由于离线环境无法在线更新插件，需通过调整插件版本组合并制作Docker镜像解决：

1. 确定兼容的插件版本组合 #

Jenkins无法同时加载同一插件的两个版本，需让Timestamper和Prism API依赖同一个antisamy-markup-formatter版本：

• 方案A：升级Prism API插件：查找Prism API支持antisamy-markup-formatter 173.v680e3a_b_69ff3的版本（如Prism API 1.31.0及以上版本，需提前确认兼容性）
• 方案B：降级Timestamper插件：将Timestamper降级到1.29版本（该版本依赖antisamy-markup-formatter 162.v0e6ec0fcfcf6）

2. 离线下载对应插件包 #

在可联网环境中，下载以下插件的.hpi包：

• 选定版本的Timestamper/Prism API插件
• 匹配的antisamy-markup-formatter版本
• 所有间接依赖插件的兼容版本（确保与Jenkins LTS版本匹配）

3. 构建自定义Docker镜像 #

创建Dockerfile，将下载的插件包复制到Jenkins默认插件目录：

# 基于目标Jenkins LTS版本构建
FROM jenkins/jenkins:2.504.2-lts

USER root
# 创建插件存放目录（若不存在）
RUN mkdir -p /usr/share/jenkins/ref/plugins
# 复制本地插件包到镜像内
COPY ./local-plugins/*.hpi /usr/share/jenkins/ref/plugins/
# 修正插件目录权限
RUN chown -R jenkins:jenkins /usr/share/jenkins/ref/plugins

USER jenkins

• 将下载的所有插件包放入本地local-plugins目录
• 执行docker build -t custom-jenkins-lts .构建镜像

4. 验证镜像可用性 #

启动容器后，检查Jenkins插件管理页面，确认所有插件均正常加载，无依赖报错。

内容的提问来源于stack exchange，提问作者Senthil13