Jenkins在Linux上的插件如何管理

Linux 上 Jenkins 插件管理指南

一 管理入口与常用方式

• Web UI：进入 Manage Jenkins → Manage Plugins，在 Available 安装、Updates 更新、Installed 卸载，支持“Install without restart”或“Install and restart”。适合交互式选择与批量勾选操作。
• Jenkins CLI：使用 jenkins-cli.jar 执行安装、更新、卸载与列表等操作，便于自动化与批量处理。
• 手动安装：下载 .hpi/.jpi 插件包到插件目录并重启，适合离线或受限网络环境。
• SSH 方式：启用 Jenkins SSH 服务后，可直接通过 SSH 执行插件相关命令（如 install-plugin、list-plugins）。

二 安装插件

• Web UI 安装：在 Available 搜索插件，勾选后点击“Install without restart”或“Install and restart”。
• CLI 安装：
  • 从更新中心安装（自动解决依赖）：
    java -jar jenkins-cli.jar -s http://your-jenkins-url/ install-plugin
  • 从本地 .hpi 安装：
    java -jar jenkins-cli.jar -s http://your-jenkins-url/ install-plugin /path/to/plugin.hpi -deploy
  • 安装后按需重启（如使用 -restart 或页面提示重启）。
• 手动安装与目录：将 .hpi 放入 $JENKINS_HOME/plugins（常见路径为 /var/lib/jenkins/plugins），然后重启 Jenkins 服务（如 systemctl restart jenkins）。注意直接操作插件目录存在风险，建议先备份。

三 更新与卸载

• Web UI：在 Updates 选项卡勾选需要更新的插件并执行更新，按提示重启。
• CLI 更新：
  • 更新单个插件：
    java -jar jenkins-cli.jar -s http://your-jenkins-url/ update-plugin
  • 批量更新全部插件：
    java -jar jenkins-cli.jar -s http://your-jenkins-url/ update-plugins -restart
• 卸载：
  • Web UI：在 Installed 选择插件并执行 Uninstall，随后重启。
  • CLI：
    java -jar jenkins-cli.jar -s http://your-jenkins-url/ uninstall-plugin
  • 手动方式：停止 Jenkins，删除 $JENKINS_HOME/plugins/* 相关文件/目录，再启动。

四 常用命令与插件列表

• 获取 CLI：
  curl -O http:///jnlpJars/jenkins-cli.jar
• 列出已安装插件：
  java -jar jenkins-cli.jar -s http:/// list-plugins
• 通过 SSH 列出插件（需启用 SSH 服务并配置端口/密钥）：
  ssh -l -p list-plugins
• 通过脚本控制台输出插件清单（Groovy）：
  Jenkins.instance.pluginManager.plugins.each{ plugin ->
  println “${it.shortName}:${it.version}”
  }
• 通过 HTTP API 获取插件信息（JSON）：
  curl -s /pluginManager/api/json?depth=1 | jq -r ‘.plugins[] | “(.shortName):(.version)”’

五 加速下载与最佳实践

• 更换插件镜像源：
  • 在 Manage Jenkins → Manage Plugins → Advanced 将 Update Site 改为国内镜像，例如：
    https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
  • 或在 $JENKINS_HOME/updates/default.json 中将更新站点域名替换为镜像地址（如将 updates.jenkinsci.org 替换为 mirrors.tuna.tsinghua.edu.cn/jenkins），保存后重启或点击“Check now”。
• 离线/受限网络：优先使用 .hpi 手动安装或内网镜像源。
• 安全与稳定：
  • 操作插件目录前先备份 $JENKINS_HOME/plugins 与关键配置。
  • 谨慎批量更新，先在测试环境验证，关注插件与 Jenkins 版本兼容性。
  • 生产环境建议采用“空闲时重启”或计划维护窗口，避免中断正在运行的任务。