Jenkins - 插件安装失败处理方法

Myth丶恋晨 2022-09-09 09:58 438阅读 0赞

> 不论是刚启动成功后进行的推荐插件安装，还是后期使用Jenkins过程中进行插件的安装。出现插件安装失败的问题，可以通过本篇解决！

【注意，**插件下载安装失败，其失败的原因是多种多样的**。这里仅说明了这些失败出现的情况是在启动安装时还是在后期使用中。】

【在下面的解决方法模块，会根据具体失败的问题进行处理

### 安装失败出现的环境 ###

初始启动安装推荐插件失败的情况

![b6e67497d0e0be825cea4fa8657bd85a.png][]

使用Jenkins过程中，插件安装失败

![8a96ac43252691890c671cb4789e725c.png][]

### 针对不同安装失败的原因，具体对应的解决方法 ###

**1、网络或墙的问题导致插件下载安装失败**

![40ab2bc08bf9e4f5b2b6f50a1a166f1e.png][]

这种错误提示很明显，就是无法连接到插件下载地址，导致插件下载失败。

**解决方法**

为Jenkins更换源

点击Jenkins主页面左侧列表中【系统管理】

![765622df760bcad7c5e9eaece7650fdd.png][]

下拉找到【管理插件】

![11ce0a1e104a024a14ee07c92080694e.png][]

选择【高级】选项卡，替换最下方【升级站点】中的URL

将

> [http://updates.jenkins-ci.org/update-center.json][http_updates.jenkins-ci.org_update-center.json]

替换为

> [http://mirror.esuni.jp/jenkins/updates/update-center.json][http_mirror.esuni.jp_jenkins_updates_update-center.json]

如下图：【详细的Jenkins的镜像地址查询：[http://mirrors.jenkins-ci.org/status.html][http_mirrors.jenkins-ci.org_status.html]】

![21c29fad9bcedd6ea165e52008799171.png][]

保存后，即可返回到【可选插件】选项卡下，进行搜索重新安装。

**2、因为Jenkins版本太低导致插件不支持**

![400fe79a515071c32227aa81977a1961.png][]

可以在线升级Jenkins的版本，即下载war包进行升级。【本人使用的Jenkins的docker镜像启动使用的，因此本方法不适合我】

![2e8a1394f005c2b68ef57a07cb78b1fc.png][]

**解决方法**

1、上面所说，因为Jenkins本身版本过低的问题，导致插件安装不成功。可以**自行升级Jenkins版本**，来解决这个问题。

2、但是像这种使用docker镜像启动的，升级Jenkins的版本是没多大戏了，除非你把这个容器和对应镜像干掉。下载更新的镜像来启动Jenkins容器。

所以可以通过**下载插件历史版本，然后在Jenkins进行上传插件**的方式来解决这个问题。也就是所谓的**手动下载上传插件安装**。

### 自行升级Jenkins版本 ###

1、一定要在Jenkins官网查找最新版本，官网地址：[https://jenkins.io/download/][https_jenkins.io_download]

2、选择对应操作方式的最新版本，例如：docker安装包   或者  windows安装包 或者 其他

![2c56db4515226cdbf0bd074c3b7ec1d1.png][]

3、docker安装步骤，参考：[https://www.cnblogs.com/sxdcgaq8080/p/10489369.html][https_www.cnblogs.com_sxdcgaq8080_p_10489369.html]

### 手动下载上传插件安装 ###

这里就以安装Docker Pipline插件为例，演示手动下载上传插件安装

1、首先咱们可以在启动的Jenkins上的 系统管理进入

![ad730ed1893ce47673dd4cf5bb44dcc4.png][]

2、可以看到错误日志中 Docker Pipline V1.17版本 所依赖的Pipline GroovyV2.57.2的版本 需要Jenkins版本在2.62以上才可以使用

![1b252934b72f68fb0687d01040067e49.png][]

3、同样在Jenkins的系统管理下的，插件管理下 可以看到

![e1c75f68f3e248263766cb8708a118ea.png][]

4、进入Jenkins的插件下载网站

下载Jenkins的插件的地址：[https://plugins.jenkins.io/][https_plugins.jenkins.io]

![a4ec754625d9c15e28751813be9e0637.png][]

搜索本插件

![33dbadd633aae97784ebaf5e75f40aa3.png][]

点击进入后，可以获取历史插件版本

![f6958b85c03c9aaad77978fa4d2ff19a.png][]

![1b779e33b6f28841d309aa8821671ca8.png][]

![eadd2350101a22689f72314b190dc834.png][]

5、进入Jenkins，进入系统管理,进入管理插件，进入高级，上传插件文件，开始上传

![1d6710cdde340255dd6e46c54b25d306.png][]

即可安装完成并且成功。需要注意的是，**如果本插件有其他依赖插件的话，需要先安装依赖插件，再进行本插件的安装，否则还会失败！！！**

[b6e67497d0e0be825cea4fa8657bd85a.png]: /images/20220829/0335a77b7efc471ab15d6d4a0903d6fc.png
[8a96ac43252691890c671cb4789e725c.png]: /images/20220829/f49365d774f049538122aa667ea5374a.png
[40ab2bc08bf9e4f5b2b6f50a1a166f1e.png]: /images/20220829/3d11b0e8368147d08a3eb5e080459d32.png
[765622df760bcad7c5e9eaece7650fdd.png]: /images/20220829/1de540194c3c4e8b954fd357ed648f20.png
[11ce0a1e104a024a14ee07c92080694e.png]: /images/20220829/ab3010e2cc51493cb33bc29c0e993180.png
[http_updates.jenkins-ci.org_update-center.json]: http://updates.jenkins-ci.org/update-center.json
[http_mirror.esuni.jp_jenkins_updates_update-center.json]: http://mirror.esuni.jp/jenkins/updates/update-center.json
[http_mirrors.jenkins-ci.org_status.html]: http://mirrors.jenkins-ci.org/status.html
[21c29fad9bcedd6ea165e52008799171.png]: /images/20220829/989c182f7c5743ca9015d8b795188a65.png
[400fe79a515071c32227aa81977a1961.png]: /images/20220829/95b5cb61ecad4626a6e5defe470110d8.png
[2e8a1394f005c2b68ef57a07cb78b1fc.png]: /images/20220829/bdc1dfa3ef704503901b7454c1339600.png
[https_jenkins.io_download]: https://jenkins.io/download/
[2c56db4515226cdbf0bd074c3b7ec1d1.png]: /images/20220829/68dad0a8e01b4907a64c421cddd3d6d9.png
[https_www.cnblogs.com_sxdcgaq8080_p_10489369.html]: https://www.cnblogs.com/sxdcgaq8080/p/10489369.html
[ad730ed1893ce47673dd4cf5bb44dcc4.png]: /images/20220829/d371e7aa69844a66a8c8044dcf71dbc2.png
[1b252934b72f68fb0687d01040067e49.png]: /images/20220829/d69570c88b9f4b019f01bce6c2efa3de.png
[e1c75f68f3e248263766cb8708a118ea.png]: /images/20220829/5709386ef2dc4a19ae8bfa7afd2f3466.png
[https_plugins.jenkins.io]: https://plugins.jenkins.io/
[a4ec754625d9c15e28751813be9e0637.png]: /images/20220829/c27839c0452046b5aecb0f97bddcef8e.png
[33dbadd633aae97784ebaf5e75f40aa3.png]: /images/20220829/8288399b487b4dfea08b0e7f600b3213.png
[f6958b85c03c9aaad77978fa4d2ff19a.png]: /images/20220829/a3a5450d540e43f1ba9727b96abe1d7e.png
[1b779e33b6f28841d309aa8821671ca8.png]: /images/20220829/1282acd10a4446758ad4ae423db91fbb.png
[eadd2350101a22689f72314b190dc834.png]: /images/20220829/47e16d0dd10443eebfc8adf8e70b18f2.png
[1d6710cdde340255dd6e46c54b25d306.png]: /images/20220829/72cb5d63073a4d0f9f409b490bb1b92c.png