Jenkins在CentOS如何进行插件管理

Jenkins在CentOS的插件管理指南

一 管理入口与常用操作

• 登录 Jenkins 管理控制台，进入 Manage Jenkins → Manage Plugins。
• 在线安装：在 Available 页搜索插件，勾选后点击 Install without restart 或 Install and restart。
• 更新插件：在 Updates 页勾选需要更新的插件，执行更新并按提示重启。
• 卸载插件：在 Installed 页选择插件并执行 Uninstall，随后重启生效。
• 验证安装：在 Installed 页确认插件出现在列表中且版本正确。

二 安装方式

• Web界面上传
  • 适用于离线环境或指定版本安装。先从插件站点下载 .hpi/.jpi 文件，进入 Manage Plugins → Advanced → Upload Plugin 上传，按提示重启。
• Jenkins CLI
  • 准备 CLI：在 Manage Jenkins → Tools and Actions 下载 jenkins-cli.jar，或到 JENKINS_URL/jnlpJars/jenkins-cli.jar 获取。
  • 常用命令示例：
    • 安装并重启：java -jar jenkins-cli.jar -s http://your-jenkins-url/ install-plugin plugin-name -restart
    • 从本地文件安装：java -jar jenkins-cli.jar -s http://your-jenkins-url/ install-plugin /path/plugin.hpi -restart
    • 从URL安装：java -jar jenkins-cli.jar -s http://your-jenkins-url/ install-plugin https://updates.jenkins.io/download/plugins/PluginName/Version/PluginName.hpi -restart
  • 说明：CLI方式便于批量、自动化与无人值守安装。

三 更新与卸载

• 更新
  • 在 Updates 页选择插件执行更新；部分场景可 Install without restart，但多数生产环境建议更新后重启以确保一致性。
• 卸载
  • 在 Installed 页执行 Uninstall 并重启；必要时可手动清理 /var/lib/jenkins/plugins/ 下对应插件目录（不建议随意删除，优先走界面卸载）。

四 国内镜像加速

• 修改插件更新站点为国内镜像（如 清华大学 TUNA）可显著提升下载速度：
  • 方式一（推荐）：在 Manage Jenkins → Manage Plugins → Advanced → Update Site 将 URL 改为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
  • 方式二：替换更新中心定义文件
    • 备份：sudo cp /var/lib/jenkins/updates/default.json /var/lib/jenkins/updates/default.json.bak
    • 使用 sed 替换域名（请先备份）：sudo sed -i ‘s#https://updates.jenkins.io/download#https://mirrors.tuna.tsinghua.edu.cn/jenkins#g’ /var/lib/jenkins/updates/default.json
  • 刷新后到 Updates 页检查是否能正常列出插件与版本。

五 常见问题与最佳实践

• 兼容性与依赖
  • 安装前确认插件与当前 Jenkins 版本兼容；部分插件有额外系统依赖，需按插件文档准备环境。
• 重启策略
  • 多数插件安装/更新后需要重启；若界面提供 Install without restart，可延后统一重启以减少中断。
• 日志与排障
  • 查看 /var/log/jenkins/jenkins.log 定位插件安装失败、依赖缺失、网络超时等问题。
• 安全与维护
  • 定期更新 Jenkins 与插件以修复安全漏洞；变更前做好 备份（如 JENKINS_HOME 目录与数据库/配置），变更后在 Installed 页核对版本。