GoCD插件用户指南
介绍
插件允许用户扩展GoCD的功能。每个插件都会被分配一个标识符,该标识符由插件元数据文件中提供的属性决定,该元数据文件与插件jar包一起打包。如果未打包元数据文件,则将采用插件jar文件名作为插件ID。插件分为两类 - 捆绑和外部。在启动时,GoCD服务器会尝试加载所有插件。成功加载后,插件将被转换为OSGi包并提取到ID attribute provided in plugin metadata file packaged along with the plugin jar. If the metadata file is not packaged, plugin jar file name will be taken as plugin id. Plugins are classified into two categories - Bundled and External. During startup, GoCD server would try to load all the plugins. On successful load, the plugin will be converted into an OSGi bundle and extracted into <server installation directory>/plugins_work
目录。插件标签页,在GoCD服务器管理下,会列出所有已加载的插件。
捆绑与外部
-
捆绑插件:顾名思义,捆绑插件是与GoCD服务器一起打包的。这些插件最初由Thoughtworks GoCD开发团队开发,现在由GoCD社区与服务器一起维护。捆绑插件位于
<server installation directory>/plugins/bundled
目录下。升级后,当GoCD服务器首次启动时,所有捆绑插件都将刷新为最新版本。 -
外部插件:所有用户编写的插件以及一些GoCD开发团队的插件被视为外部插件。与捆绑插件不同,外部插件在GoCD服务器升级期间不会被更改(即打包、捆绑、刷新、删除或修改)。外部插件从
<server installation directory>/plugins/external
目录。外部插件列表
插件的安装和卸载
您需要访问GoCD服务器机器才能安装/卸载插件。要安装插件,请将插件jar放到外部插件目录下 (<server installation directory>/plugins/external
) 并重启GoCD服务器。要卸载插件,请从外部插件目录 (<server installation directory>/plugins/external
) 中删除插件jar并重启GoCD服务器。
插件标签页
可以在GoCD服务器管理下找到插件标签页。插件标签页显示当前已加载的所有插件及其详细信息和状态。如果插件被标记为无效或不兼容,这里将报告相应的原因。
注意事项
- 只有在GoCD服务器重启后,添加/删除/升级插件才会生效。
- 两个插件不能具有相同的ID无论它是捆绑插件还是外部插件。
- 如果有两个具有相同ID的外部插件可用,则只有一个将在无特定顺序的情况下成功加载。
- 如果有一个捆绑插件和一个外部插件具有相同的ID,则仅加载捆绑插件。