Jenkins用户手册-管理插件

Jenkins用户手册（3）

Managing Plugins

插件是用于增强Jenkins功能以满足机构或者用户特定的需求。有多于一千种不同插件可以安装到Jenkins上以集成不同的构建工具、云服务提供、分析工具等等，Jenkins插件由Update Center提供。

此处将讲解使用Jenkins Web UI对插件的基本管理。

Installing a plugin

Jenkins提供了两种安装插件的方法：

• 使用Web UI中的Plugin Manager。
• 使用Jenkins CLI的install-plugin命令。

这两种方式都需要Jenkins能够从Update Center下载元数据，无论是Jenkins项目的Update Center还是一个订制的Update Center.

所有插件都是以.hpi结尾的文件自包含式打包，含有必要的代码、片和其他一些插件运行必须的资源。

From the web UI

最简单的插件安装方式即为通过Jenkins的Web UI的Manage Jenkins下的Manage Plugins视图，需要管理员权限。

Using the Jenkins CLI

管理员也可以使用Jenkins命令行工具安装插件。

java -jar jenkins-cli.jar -s http://localhost:8080/ install-plugin SOURCE ... [-deploy][-name VAL][-restart]

Installs a plugin either from a file , an URL , or from update center

安装插件，要么从文件，要么从URL，要么从Update Center

SOURCE      :如果指向本地文件，直接安装。如果指向一个URL，由Jenkins下载后安装。否则，Jenkins会认为是            已存于Update Center中的插件名字（短名字，如findbugs）,从Update Center安装。

-deploy     :无延迟发布。

-name VAL   :如果指定，指定插件Update Center中的短名字。

-restart    :成功安装后重启Jenkins.

如果要安装老版本插件。需如下四步：

• 进入ManageJenkins下Manage Plugins视图。
• 点击Advanced选项卡。
• 选择Upload Plugin区域下的.hpi文件。
• Upload插件文件。

此操作需要管理员权限，且操作完成需手工重启以使操作生效。

如果已下载好了.hpi文件，且能够直接将其放入Jenkins相关目录，那么可直接将此文件放入JENKINS_HOME/plugins目录下，然后重启Jenkins即可。

Updating a plugin

更新插件位于Manage Plugins的Updates选项卡。

默认情况下，Jenkins主服务每24小时从Update Center检查一次更新。如果要手动触发检查更新操作，点击Updates选项卡中的Check now按钮。

Removing a plugin

当Jenkins环境中的一个插件不在使用时，需将其从Jenkins服务删除。这样做有大量好处，比如减少启动和运行时内存消耗、减少配置选项、减少同新插件冲突的概率。

Uninstalling a plugin

可以通过Manage Plugins的Installed选项卡中的Uninstall按钮卸载，也可以通过删除插件对应的.hpi文件，其位于Jenkins主服务的JENKINS_HOME/plugins目录下。重启后生效。

注：如果存在插件依赖被删除的.hpi文件对应的插件，Jenkins可能会启动失败。

卸载一个插件不会删除其可能已创建的配置。如果存在被已删除插件创建的jobs/nodes/views/builds/etc配置，在Jenkins启动期间，将会有有警告信息：不能完全加载和忽略不认识的数据。

Removing old data

Jenkins提供一个清除卸载插件后遗留的配置的功能。在Manage Jenkins的Manage Old Data处检索和删除老的数据。

Disabling a plugin

禁用一插件是退下一个插件的温柔方式。Jenkins依然认为此插件处于已安装状态的，但是不会启动这个插件，也不会有此插件的扩民可见。

禁用插件功能在Manage Plugins下的Intalled选项卡下。系统管理员也可以通过在Jenkins主服务上创建一个文件来禁用插件，如：JENKINS_HOME/plugins/PLUGIN_NAME.hpi.disabled.