Jenkins在Ubuntu上的插件管理

Jenkins在Ubuntu上的插件管理

一 常用安装方式

• 在线安装（推荐）
  • 访问 http://<服务器IP>:8080，登录后进入 Manage Jenkins → Manage Plugins → Available，搜索并勾选所需插件，点击 Install without restart 或 Install and restart 完成安装。适用于绝大多数环境与快速迭代场景。
• 上传离线 HPI 文件
  • 在插件官网下载 .hpi/.jpi 文件，进入 Manage Plugins → Advanced → Upload Plugin 选择文件上传并安装；安装完成后按提示重启。适合受限网络或内网环境。
• 手动放置插件文件
  • 将 .hpi 文件复制到 /var/lib/jenkins/plugins/，执行权限设置（如：sudo chown jenkins:jenkins /var/lib/jenkins/plugins/*.hpi），再重启 Jenkins 生效。适合脚本化与批量部署。
• 使用 Jenkins CLI
  • 下载 jenkins-cli.jar，执行安装：java -jar jenkins-cli.jar -s http:/// install-plugin <plugin-name.hpi>；如需更新/卸载：update-plugin / uninstall-plugin 。适合自动化与批量管理。

二 更新与卸载

• 更新
  • Web 界面：Manage Jenkins → Manage Plugins → Updates，勾选需要更新的插件并点击 Update，按提示重启。
  • CLI：java -jar jenkins-cli.jar -s http:/// update-plugin 。
  • 自动更新：在 Manage Plugins → Advanced 勾选 Automatically download and install updates when available，并设置重启策略；建议避开业务高峰。
• 卸载
  • Web 界面：Manage Jenkins → Manage Plugins → Installed，在目标插件右侧点击 Uninstall。
  • CLI：java -jar jenkins-cli.jar -s http:/// uninstall-plugin 。

三 加速与网络问题处理

• 更换插件更新源
  • 编辑 /var/lib/jenkins/hudson.model.UpdateCenter.xml，将 url 改为国内镜像（如：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json），重启 Jenkins 后生效。
• 证书与连通性
  • 如遇 SSL 证书问题，可使用 SSLPoke.class 验证与信任更新中心证书，确保 HTTPS 连通后再进行插件操作。

四 常用运维命令

• 重启与热重载
  • 重启服务：sudo systemctl restart jenkins
  • 安全热重载：http://:8080/reload
  • 安全关闭：http://:8080/exit
  • 直接重启（不推荐生产）：http://:8080/restart
• 权限与目录
  • 插件目录：/var/lib/jenkins/plugins/
  • 确保插件文件属主为 jenkins:jenkins，避免因权限导致加载失败。

五 最佳实践

• 定期更新与安全
  • 至少每周检查 Updates 选项卡，优先更新涉及安全与核心能力的插件（如 Git、Maven、Docker 相关），并在维护窗口执行。
• 兼容性与回滚
  • 更新前确认插件与当前 Jenkins 版本兼容；变更前备份 JENKINS_HOME（默认 /var/lib/jenkins） 或关键配置文件，出现问题时可快速回滚。
• 精简与治理
  • 卸载长期未使用的插件，减少启动时间与内存占用，降低冲突概率。
• 界面与体验
  • 可结合 Blue Ocean 等插件优化流水线可视化与操作体验。