Jenkins Linux版如何管理插件

Jenkins Linux 版插件管理指南

一 常用方式总览

• 通过 Web 界面：进入 Manage Jenkins → Manage Plugins，在 Available 搜索并勾选插件，选择 Install without restart 或 Install and restart；在 Updates 执行更新；在 Installed 执行卸载或禁用。适合日常可视化操作与批量选择。
• 通过 Jenkins CLI：使用 jenkins-cli.jar 执行安装、更新、卸载，便于自动化与脚本化管理。
• 手动安装与离线环境：下载 .hpi/.jpi 插件包，Web 界面 Advanced → Upload Plugin 上传；或解压到 $JENKINS_HOME/plugins 目录后重启。适合内网/离线环境。

二 安装插件

• Web 界面安装
  1. 登录 http://<服务器IP>:8080 → Manage Jenkins → Manage Plugins → Available；2) 搜索插件（如 Git、Maven Integration）；3) 勾选并选择 Install without restart 或 Install and restart；4) 安装完成后在 Installed 查看状态。
• 上传插件包安装
  1. 在插件官网下载 .hpi；2) Manage Plugins → Advanced → Upload Plugin 选择文件上传；3) 上传完成后按提示重启。
• 命令行安装
  1. 准备 CLI：下载 jenkins-cli.jar；2) 执行安装：
     java -jar jenkins-cli.jar -s http:/// install-plugin <plugin-name或.hpi> [-restart]
     示例：java -jar jenkins-cli.jar -s http://localhost:8080/ install-plugin git -restart
• 离线解压安装
  1. 将插件包解压到 $JENKINS_HOME/plugins（插件目录名通常为插件 ID）；2) 重启 Jenkins 生效。

三 更新与卸载

• 更新插件
  1. Manage Plugins → Updates 勾选需要更新的插件，点击 Download now and install after restart；2) 按提示重启；3) 可点击 Check now 手动触发更新中心检查。
• 卸载插件
  1. Manage Plugins → Installed 选择插件并点击 Uninstall；2) 按提示重启；3) 卸载不会自动清除历史配置，后续可到 Manage Jenkins → Manage Old Data 清理。
• 禁用插件（不删除文件）
  1. Web 界面在 Installed 取消勾选对应插件以禁用；2) 或在 $JENKINS_HOME/plugins 创建空文件 <PLUGIN_ID>.jpi.disabled 实现禁用，删除该文件即可恢复。

四 目录结构与注意事项

• 关键目录与文件
  • 插件目录：$JENKINS_HOME/plugins（默认 /var/lib/jenkins/plugins），插件以目录形式存在，目录名为插件 ID；
  • 更新站点缓存：$JENKINS_HOME/updates/default.json（可配置镜像源以加速下载）。
• 手动操作风险与建议
  • 直接删除 .hpi 或移动目录可能导致依赖异常或启动失败，操作前建议备份 $JENKINS_HOME；
  • 插件被卸载后其历史配置仍可能保留，必要时在 Manage Old Data 清理；
  • 禁用插件是比卸载更安全的回退方式，便于快速排查问题。

五 加速下载与常见问题处理

• 下载加速
  • 修改更新站点镜像：编辑 $JENKINS_HOME/updates/default.json，将 http://updates.jenkins-ci.org/download 替换为 https://mirrors.tuna.tsinghua.edu.cn/jenkins；保存后重启或点击 Check now。
• 常见问题
  • 可用插件列表为空或很久不动：在 Updates 点击 Check now 强制刷新元数据；
  • 安装或更新后建议重启，确保插件与依赖正确加载；
  • 升级或插件升级导致 配置无法保存：优先升级提示有问题的插件，或新建任务逐项排查出问题的插件并升级。