Ubuntu上扩展Jenkins插件功能的实用指南
一 安装与更新插件
- 通过 Web 界面安装
- 登录 Jenkins（默认地址 http://<服务器IP>:8080），进入 Manage Jenkins → Manage Plugins。
- 在 Available 选项卡搜索并勾选所需插件，选择 Install without restart 或 Install and restart 完成安装。
- 安装后在 Installed 选项卡确认，必要时按提示重启。
- 使用 Jenkins CLI 批量安装
- 准备命令行工具 jenkins-cli.jar，执行：
java -jar jenkins-cli.jar -s http:/// install-plugin
安装完成后按需重启 Jenkins。
- 手动安装与上传
- 从 Jenkins 插件官网下载 .hpi/.jpi 文件，放入 /var/lib/jenkins/plugins/ 后重启：
sudo systemctl restart jenkins
- 或在 Manage Plugins → Advanced → Upload Plugin 上传 .hpi 文件并重启。
- 更新与卸载
- 在 Updates 选项卡选择插件执行更新，按提示重启。
- 在 Installed 选项卡选择插件执行卸载，或删除 /var/lib/jenkins/plugins/ 下对应文件后重启。
二 常用插件与典型集成场景
- 源码与构建
- Git plugin：拉取代码；在 Global Tool Configuration 配置 Git executable（常见路径 /usr/bin/git）。
- Maven Integration plugin：构建 Maven 项目；在 Global Tool Configuration 配置 JDK 与 Maven 安装目录或 settings.xml。
- 测试与报告
- JUnit 报告：构建步骤执行测试（如 pytest 生成 test-results.xml），再添加 Publish JUnit test result report 步骤并指向报告路径。
- 测试管理：安装 TestRail 插件，在 Manage Jenkins → Configure System 配置 URL 与认证，在任务构建后操作选择 Publish TestRail test result 并填写相关信息。
- 交付与发布
- Publish Over SSH：在 系统设置 配置 SSH Server，在任务中使用该插件将制品发布到目标主机。
三 加速下载与镜像源配置
- 使用国内镜像更新站点
- 在 Manage Jenkins → Manage Plugins → Advanced → Update Site 将 URL 替换为：
https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
保存后回到插件页检查更新与安装。
- 说明
- 镜像可显著提升插件下载速度，避免外网不稳定导致的安装失败。
四 安全与维护最佳实践
- 保持插件定期更新，及时获取功能修复与安全补丁。
- 安装前核对插件与当前 Jenkins 版本的兼容性，必要时先在测试环境验证。
- 采用 Blue Ocean 等插件优化流水线可视化与操作体验。
- 变更前备份 JENKINS_HOME（如 /var/lib/jenkins），变更后逐步重启并观察系统日志与构建稳定性。
五 故障排查要点
- 插件安装或更新后未生效：重启 Jenkins 并再次检查 Installed 页面状态。
- 依赖缺失：部分插件需要系统级依赖（如 Git、Java、构建工具链）；按插件文档安装依赖后重启。
- 下载缓慢或失败：切换为国内镜像源后重试，或在网络稳定时段执行安装。
- CLI 连接失败：确认 jenkins-cli.jar 版本与目标 Jenkins URL 正确，网络与权限可达。
