管理插件

插件是增强Jenkins环境功能以满足组织或用户特定需求的主要手段。必威国际有限公司有超过1000个不同的插件它可以安装在Jenkins控制器上,并集成各种构建工具、必威国际有限公司云提供商、分析工具等。

插件可以自动下载,以及它们的依赖58必威网站 .更新中心是由Jenkins项目运营的一项服务,它提供了由Jenkins社区的各种成员开发和维护必威国际有限公司的开源插件清单。

本节将涵盖从在Jenkins web UI中管理插件的基础知识到在Jenkins web UI中进行更改的所有内容必威国际有限公司58必威网站 文件系统。

安装一个插件

必威国际有限公司Jenkins提供了几种在master上安装插件的方法:

  1. 使用web UI中的“插件管理器”。

  2. 使用必威国际有限公司詹金斯CLIinstall-plugin命令。

每种方法都会导致插件被Jenkins加载,但可能需要不同级别的访问和权衡才能使用。必威国际有限公司

这两种方法都要求Jenkins控制器能够从更新中心下载元数据,无论主更新必威国际有限公司中心是由Jenkins项目操作的1,或自定义更新中心。

插件被打包成自包含的.hpi文件,其中包含插件成功运行所需的所有必要代码、图像和其他资源。

从web UI

最简单和最常见的安装插件的方法是通过管理詹金斯必威国际有限公司>管理插件视图,供Jenkins环境的管理员使用。必威国际有限公司

可用选项卡,可从配置的更新中心下载的插件可以搜索和考虑:

插件管理器中的可用选项卡

大多数插件都可以通过勾选插件旁边的复选框并单击来立即安装和使用安装没有重启

如果可用插件列表为空,则主插件可能配置错误,或者还没有从更新中心下载插件元数据。单击检查现在按钮将迫使詹金斯尝试联系其配置的更新必威国际有限公司中心。

使用Jenkins 必威国际有限公司CLI

管理员也可以使用必威国际有限公司詹金斯CLI它提供一个安装插件的命令。用于管理Jenkins环境的脚本或配必威国际有限公司置管理代码可能需要安装插件,而不需要在web UI中直接与用户交互。Jenk必威国际有限公司ins CLI允许命令行用户或自动化工具下载插件及其依赖项。

java -jar 必威国际有限公司jenkins-cli.jar -s http://localhost:8080/ install-plugin SOURCE…[-deploy] [-name VAL] [-restart]从文件、URL或更新中心安装插件。SOURCE:如果它指向一个本地文件,那么将安装该文件。如果这是一个URL, Jenkins会必威国际有限公司下载这个URL并将其作为插件安装。其他wise the name is assumed to be the short name of the plugin in the existing update center (like "findbugs"),and the plugin will be installed from the update center. -deploy : Deploy plugins right away without postponing them until the reboot. -name VAL : If specified, the plugin will be installed as this short name (whereas normally the name is inferred from the source name automatically). -restart : Restart Jenkins upon successful installation.

先进的安装

更新中心只允许安装插件的最新发布版本。如果需要旧版本的插件,Jenkins管理员可以下载旧版本的插件必威国际有限公司.hpi归档并手动安装到Jenkins控制器上。必威国际有限公司

从web UI

假设.hpi文件已经下载,登录的Jenkins管理员可以从web UI内上传文件:必威国际有限公司

  1. 导航到管理詹金斯必威国际有限公司>管理插件页面。

  2. 点击先进的选项卡。

  3. 选择.hpi下的文件上传插件部分。

  4. 上传插件文件。

插件管理器中的高级选项卡

插件文件上传后,必须手动重启Jenkins控制器,以使更改生效。必威国际有限公司

在主

假设.hpi文件已被系统管理员显式下载,管理员可以手动放置.hpi文件系统中指定位置的文件。

复制下载.hpi”文件到必威国际有限公司JENKINS_HOME /插件目录(例如,在Debian系统上)必威国际有限公司必威国际有限公司JENKINS_HOME通常是/var/lib/必威国际有限公司jenkins).

在加载插件并使其在Jenkins环境中可用之前,需要重新启动master。必威国际有限公司

更新站点中插件目录的名称1并不总是与插件的显示名相同。搜索plugins.必威国际有限公司jenkins.io为所需的插件提供适当的链接.hpi文件。

更新插件

更新列于更新选项卡的管理插件页面,可以通过勾选所需插件更新的复选框并单击现在下载,重启后安装按钮。

在插件管理器中的更新选项卡

默认情况下,Jenkins控制器必威国际有限公司将每24小时检查一次来自更新中心的更新。要手动触发更新检查,只需单击检查现在按钮更新选项卡。

删除一个插件

当一个插件不再在Jenkins环境中使用时,审慎的做法是从Jenkins控必威国际有限公司制器中删除该插件。这提供了许多好处,如减少启动或运行时的内存开销,减少web UI中的配置选项,并消除了未来与新插件更新的潜在冲突。

卸载插件

卸载插件最简单的方法是导航到安装选项卡上的管理插件页面。从那里,Jenkins将必威国际有限公司自动确定哪些插件可以安全卸载,哪些插件不依赖于其他插件,并显示一个按钮。

插件管理器中的已安装选项卡

也可以通过删除相应的插件来卸载插件.hpi文件从必威国际有限公司JENKINS_HOME /插件主服务器上的目录。插件将继续运行,直到主服务器重新启动。

如果一个插件.hpi文件被删除,但需要其他插件,Jenkins控制器可能无法正确引导。必威国际有限公司

卸载插件就可以了删除插件可能创建的配置。如果有现有的job /nodes/views/builds/etc配置引用了插件创建的数据,在启动期间Jenkins会警告某些配置无法完全加载,并忽略未识别的数据。必威国际有限公司

由于配置将被保留,直到它们被覆盖,重新安装插件将导致这些配置值重新出现。

删除旧数据

必威国际有限公司Jenkins提供了一个工具来清除被卸载的插件留下的配置。导航到管理詹金斯必威国际有限公司然后点击管理旧数据检查和删除旧数据。

禁用插件

禁用插件是一种较为温和的插件退役方式。必威国际有限公司Jenkins将继续识别插件已安装,但它不会启动插件,并且该插件的扩展将不可见。

控件必威国际有限公司上的复选框可以禁用插件安装选项卡的管理插件页面(见下文)。

插件管理器中的已安装选项卡

系统管理员也可以通过在Jenkins控制器上创建一个文件来禁用插件,例如:必威国际有限公司必威国际有限公司JENKINS_HOME /插件/ PLUGIN_NAME.hpi.disabled

被禁用插件创建的配置行为就像插件被卸载一样,在引导时导致警告,但在其他情况下会被忽略。

使用Jenkins 必威国际有限公司CLI

也可以通过控件启用或禁用插件必威国际有限公司詹金斯CLI使用enable-plugindisable-plugin命令。

enable-plugin命令被添加到Jenkins中必威国际有限公司v2.136.的disable-plugin命令被添加到Jenkins中必威国际有限公司v2.151

enable-plugin命令接收要启用的插件列表。所选插件所依赖的任何插件也将通过此命令启用。

java -jar 必威国际有限公司jenkins-cli.jar -s http://localhost:8080/ enable-plugin PLUGIN…[-restart]启用一个或多个已安装的插件。PLUGIN:启用具有给定短名称的插件及其依赖项。-restart:启用插件后重新启动J必威国际有限公司enkins。

disable-plugin命令接收要禁用的插件列表。输出将显示成功和失败操作的消息。如果您只想看到错误消息,则安静的选项。的策略选项控制当一个指定的插件被列为另一个已启用插件的可选或强制依赖项时将采取什么操作。

java -jar 必威国际有限公司jenkins-cli.jar -s http://localhost:8080/ disable-plugin PLUGIN…[-quiet (-q)] [-restart (-r)] [-strategy (-s) strategy]禁用一个或多个已安装的插件。禁用带有给定短名称的插件。您可以定义如何继续处理相关插件,以及是否应该重新启动。你也可以设置安静模式来避免控制台上的额外信息。PLUGIN:要禁用的插件。-quiet (-q):保持安静,只打印错误信息-restart (-r):禁用插件后重启Jenkins。必威国际有限公司-strategy (-s)策略:如何处理依赖插件。—none:当强制依赖插件存在且启用时,不可以禁用(默认值)。- mandatory:禁用所有强制依赖插件,可选依赖插件保持启用状态。 - all: all dependant plugins are also disabled, no matter if its dependency is optional or mandatory.

与从UI中启用和禁用插件需要重新启动来完成该过程相同,使用CLI命令所做的更改将在Jenkins重新启动后生效。必威国际有限公司的重新启动选项强制在命令成功完成后安全重新启动实例,因此将立即应用更改。

固定的插件

固定插件特性在Jenkins 2.0中被移除。必威国际有限公司Jenkins 2.0之后的版本没有捆绑必威国际有限公司插件,而是提供了一个向导来安装最有用的插件。

的概念固定的插件适用于与Jenkins 1绑定的插件。必威国际有限公司X,如矩阵授权插件

默认情况下,无论何时Jenkins升级,其必威国际有限公司绑定的插件都会覆盖当前安装的插件版本必威国际有限公司JENKINS_HOME

但是,当一个绑定的插件被手动更新时,Jenkins会将该插件标记为固定到特定版本。必威国际有限公司在文件系统上,Jenkins创建了一个名必威国际有限公司为必威国际有限公司JENKINS_HOME /插件/ PLUGIN_NAME.hpi.pinned来表示钉住。

在Jenkins启动期间,固定插件永远不会被绑定插件覆盖。必威国际有限公司(更新版本的Jenkins确实警告你,必威国际有限公司如果一个固定插件是而不是当前绑定的。)

将绑定的插件升级到升级中心提供的版本是安全的。这通常是必要的,以获得最新的功能和修复。捆绑版本偶尔会更新,但不是一致的。

插件管理器允许显式地解绑定插件。的必威国际有限公司JENKINS_HOME /插件/ PLUGIN_NAME.hpi.pinned文件也可以手动创建/删除,以控制固定行为。如果固定文件,Jenkins将使用用户指定必威国际有限公司的任何插件版本。如果文件缺失,Jenkins会在启动时将插件恢必威国际有限公司复到默认版本。



这个页面有用吗?

请通过这个提交你对这个页面的反馈快速形成

或者,如果您不希望完成快速表单,您可以简单地指出,如果您觉得这个页面有帮助?


看到现有的反馈在这里