如何在Linux上配置Jenkins的插件

Linux上配置Jenkins插件的实用步骤

一 准备与环境检查

• 确保 Jenkins 已启动并可访问：在浏览器打开 http://服务器IP:8080，完成初始解锁（查看 /var/lib/jenkins/secrets/initialAdminPassword）与初始化管理员账户。
• 确认插件目录与权限：插件默认目录为 /var/lib/jenkins/plugins，Jenkins 运行用户（如 jenkins）需对该目录具备读写权限。
• 准备离线安装包：无法访问外网时，提前从官方更新站点下载所需插件的 .hpi 文件（注意与当前 Jenkins 版本兼容）。

二 在线安装插件

• 通过 Web 界面安装
  • 进入 Manage Jenkins → Manage Plugins → Available，搜索并勾选所需插件。
  • 选择 Install without restart 或 Install and restart 完成安装；安装后可在 Installed 页查看与卸载。
• 使用 Jenkins CLI 批量安装
  • 下载 jenkins-cli.jar，执行示例：java -jar jenkins-cli.jar -s http://your-jenkins-url/ install-plugin （可叠加多个插件名，安装后按需重启）。
• 常用插件示例
  • Git、Maven Integration、Pipeline、Docker Pipeline、JUnit、Html Publisher（按项目需要选择）。

三 离线安装插件

• 在插件管理页 Advanced → Upload Plugin 上传 .hpi 文件，上传完成后按提示重启 Jenkins。
• 或手动将 .hpi 放入 /var/lib/jenkins/plugins/ 并重启 Jenkins 服务（不推荐直接解压覆盖，优先使用上传方式以确保元数据正确）。
• 离线环境建议提前下载插件的依赖项（同一页面或相关页面提供依赖 .hpi），一并上传以避免安装失败。

四 常用插件与后续配置

• 典型组合与用途
  • Git：拉取源码
  • Maven Integration：创建 Maven 项目、执行构建
  • NodeJS：前端工程环境
  • Publish Over SSH：将构建产物推送到目标服务器
  • Pipeline：流水线即代码
  • Docker Pipeline：在流水线中使用 Docker
  • JUnit / Html Publisher：测试与报告展示
• 安装后必要的系统配置
  • 进入 Manage Jenkins → System Configuration：配置 环境变量、Publish over SSH（新增目标主机、填写 SSH 密钥 或密码、点击 Test Configuration 验证）。
  • 进入 Manage Jenkins → Global Tool Configuration：配置 JDK、Maven、Git、NodeJS 等工具路径或自动安装，使流水线与任务可直接调用。

五 加速下载与维护管理

• 更换插件更新源（提升国内下载速度）
  • 在 Manage Jenkins → Manage Plugins 页面先切到 Available 页等待元数据加载，然后进入 Advanced 将 Update Site 修改为镜像源，例如：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json，保存并重启 Jenkins。
• 更新与卸载
  • 在 Updates 页检查可用更新并执行更新；在 Installed 页选择插件执行 Uninstall，按提示重启。
• 稳定性建议
  • 插件安装或升级前在测试环境验证，关注与当前 Jenkins 版本 的兼容性；生产环境变更前做好备份与回滚预案。