在 Ubuntu 上集成 Jenkins 插件的完整指南
一 准备与环境检查
- 确保已安装 Java（推荐 OpenJDK 11 或 17）：
- 安装示例：
sudo apt update && sudo apt install openjdk-11-jdk -y
- 验证：
java -version
- 确保 Jenkins 已安装并运行，默认端口 8080：
- 启动/开机自启：
sudo systemctl start jenkins && sudo systemctl enable jenkins
- 访问：
http://<服务器IP>:8080
- 初始管理员密码：
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
- 登录后建议先完成 安装推荐插件 的初始化向导，为后续插件集成打好基础。
二 通过 Web 界面安装与配置
- 进入插件管理：点击左侧 Manage Jenkins → Manage Plugins。
- 在线安装：
- 在 Available 选项卡搜索插件（如 Git、Pipeline、Blue Ocean 等），勾选后点击 Install without restart 或 Install and restart。
- 离线安装：
- 在插件站点下载 .hpi/.jpi 文件，进入 Manage Plugins → Advanced → Upload Plugin 上传并安装。
- 验证与配置：
- 在 Installed 选项卡确认插件已启用。
- 如需使用，进入 Manage Jenkins → Global Tool Configuration 配置 JDK、Git、Maven/Gradle 等工具路径；在 Configure System 配置系统级参数（如 Jenkins URL、邮箱等）。
- 在任务（Freestyle 或 Pipeline）中使用插件能力，例如选择 Git 作为源码管理、添加构建步骤或构建后操作。
三 使用 CLI 或手动方式批量集成
- Jenkins CLI 安装插件（适合自动化/批量）：
- 准备 CLI：从 Jenkins 首页 → Manage Jenkins → Tools and Actions 下载 jenkins-cli.jar，或直接使用命令：
wget http://<JENKINS_URL>/jnlpJars/jenkins-cli.jar
- 安装示例：
- 在线安装：
java -jar jenkins-cli.jar -s http://<JENKINS_URL>/ install-plugin <plugin-id> -deploy
- 本地文件安装：
java -jar jenkins-cli.jar -s http://<JENKINS_URL>/ install-plugin /path/to/plugin.hpi -deploy
- 安装后重启（如未使用 -deploy）：
java -jar jenkins-cli.jar -s http://<JENKINS_URL>/ safe-restart
- 手动安装（离线环境）：
- 将 .hpi/.jpi 文件复制到 /var/lib/jenkins/plugins/（必要时设置属主为 jenkins:jenkins），然后重启服务：
sudo systemctl restart jenkins
- 说明：CLI 与手动安装都会自动拉取并安装 依赖插件，无需逐一手动处理。
四 常用插件与集成示例
- 源码与流水线：
- Git：源码管理；Pipeline：流水线即代码；Blue Ocean：可视化流水线体验。
- 测试与质量：
- JUnit：测试报告展示（配合构建步骤执行测试并生成 JUnit XML 报告）。
- 示例（集成 pytest 并发布测试报告）：
- 在构建代理安装 pytest：
pip install pytest
- 构建步骤执行：
pytest --junit-xml=test-results.xml
- 构建后操作添加 Publish JUnit test result report，将 Test report XMLs 设为
test-results.xml。
- 其他业务插件（如 TestRail）可在 Manage Plugins 搜索安装，并在 Configure System 配置 URL/凭证，在任务构建后操作中发布结果。
五 插件管理与加速建议
- 更新与卸载：
- 在 Manage Plugins → Updates 选择插件执行 Update；在 Installed 选项卡执行 Uninstall；必要时重启生效。
- 镜像加速（提升国内下载速度）：
- 在 Manage Jenkins → Manage Plugins → Advanced → Update Site 将 URL 修改为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json，保存后获取更新索引并安装插件。
- 稳定性与兼容性：
- 定期更新插件以获取 功能与安全修复；安装前确认与当前 Jenkins 版本 的 兼容性，避免冲突。