Jenkins在Linux上如何进行插件管理

Linux上Jenkins插件管理实操指南

一 管理入口与常用操作

• 通过Web界面：登录 http://<服务器IP>:8080 → Manage Jenkins → Manage Plugins。在 Available 搜索并勾选插件，选择 Install without restart 或 Install and restart；在 Updates 执行更新；在 Installed 对已安装插件执行 Uninstall。
• 常用动作一览：

  动作	界面路径	说明
  安装	Manage Jenkins → Manage Plugins → Available	搜索并勾选，选择安装方式
  更新	Manage Jenkins → Manage Plugins → Updates	批量或单个更新
  卸载	Manage Jenkins → Manage Plugins → Installed	卸载后按提示重启
  以上路径与按钮在 Ubuntu/CentOS 等常见发行版一致。

二 命令行与离线安装

• 使用Jenkins CLI（推荐批量/自动化）
  1. 从 Manage Jenkins → Global Tool Configuration 下载 jenkins-cli.jar；2) 执行安装：
     java -jar jenkins-cli.jar -s http:/// install-plugin <plugin-name|plugin.hpi>
  2. 如需更新：java -jar jenkins-cli.jar -s http:/// update-plugin ；如需卸载：java -jar jenkins-cli.jar -s http:/// uninstall-plugin ；安装/更新后按页面或命令提示重启。
• 手动上传或离线安装
  1. 从 https://plugins.jenkins.io/ 下载 .hpi/.jpi；2) Web端 Manage Plugins → Advanced → Upload Plugin 上传；或 3) 将文件放入 /var/lib/jenkins/plugins/（必要时备份后覆盖），然后重启：sudo systemctl restart jenkins。
• 容器场景（Docker）
  优先将插件目录挂载为卷（例如 -v jenkins_plugins:/var/lib/jenkins/plugins），在宿主机下载 .hpi 放入卷内并重启容器，避免每次重建镜像。

三 网络优化与镜像源配置

• 使用国内镜像源加速
  • 更新站点镜像：编辑 /etc/sysconfig/jenkins 或 /etc/default/jenkins，设置 JENKINS_UC=https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/，保存后重启；
  • 更新中心JSON：查找并更新 default.json（Jenkins 更新中心缓存），例如将清华镜像的 dynamic-/update-center.json 下载并重命名为 default.json，重启生效。
• 代理设置
  在 Manage Jenkins → Manage Plugins → Advanced 配置 HTTP Proxy，解决内网/受限网络下载问题。

四 常见问题与最佳实践

• 常见问题处理
  • 安装失败或不兼容：优先升级 Jenkins 至兼容版本；必要时回退插件版本或改用离线安装。
  • 权限问题：确保 Jenkins 用户对 /var/lib/jenkins/plugins 有读写权限；必要时使用 sudo 执行重启。
  • 端口冲突：在 /etc/sysconfig/jenkins 调整 JENKINS_PORT 后重启。
• 最佳实践
  • 定期在 Updates 页更新插件，关注安全公告；
  • 安装前核对插件与当前 Jenkins版本 的兼容性；
  • 变更前备份 /var/lib/jenkins/plugins 与关键配置，便于快速回滚。