在 CentOS 上集成 Jenkins 插件的完整步骤
一 准备与环境检查
- 确保 Jenkins 已安装并可访问：在 CentOS 上可通过 YUM 安装并启动服务，访问 http://服务器IP:8080。初始管理员密码位于 /var/lib/jenkins/secrets/initialAdminPassword。如需修改端口或运行用户，可编辑 /etc/sysconfig/jenkins（如：JENKINS_PORT、JENKINS_USER），然后重启服务生效。以上为后续插件安装提供基础运行环境。
二 插件安装方式
- 方式一 Web UI 在线安装（最常用）
- 路径：Manage Jenkins → Manage Plugins → Available，搜索并勾选所需插件，选择 Install without restart 或 Download now and install without restart；安装完成后按提示重启。常用插件示例：Git、Maven Integration、Pipeline、Docker Pipeline、JUnit、Html Publisher。
- 方式二 上传 HPI 文件安装（离线或指定版本）
- 路径：Manage Jenkins → Manage Plugins → Advanced → Upload Plugin，选择本地 .hpi 文件上传并重启；或在插件目录放置 .hpi 后重启（适用于内网/离线环境）。
- 方式三 Jenkins CLI 批量安装（自动化/脚本化）
- 准备 CLI：下载 jenkins-cli.jar，确保与 Jenkins URL 可达。
- 常用命令示例：
- 安装插件：java -jar jenkins-cli.jar -s http://your-jenkins-url/ install-plugin -deploy
- 安装本地/远程 HPI：java -jar jenkins-cli.jar -s http://your-jenkins-url/ install-plugin /path/to/plugin.hpi 或 -url -deploy
- 重启：java -jar jenkins-cli.jar -s http://your-jenkins-url/ safe-restart
- 适合 CI/CD 初始化脚本、批量部署与无人值守环境。
三 常用插件与用途
| 插件名称 |
主要用途 |
| Git Plugin |
与 Git 仓库交互，拉取/推送代码 |
| Maven Integration Plugin |
Maven 项目构建与依赖管理 |
| Pipeline Plugin |
定义与管理 Jenkinsfile 流水线 |
| Docker Pipeline Plugin |
在流水线中执行 Docker 构建与部署 |
| JUnit Plugin |
发布与展示 JUnit 测试报告 |
| Html Publisher Plugin |
发布构建产物 HTML 报告 |
| Deploy to container Plugin |
将应用部署到 Tomcat 等容器 |
| Gitee/GitHub Authentication plugin |
Gitee/GitHub 认证与集成 |
| Locale plugin |
界面国际化（如 zh_CN） |
| 以上插件覆盖源码管理、构建、容器化与报告等常见场景，可按项目需要组合安装。 |
|
四 安装后配置与验证
- 全局工具配置：Manage Jenkins → Global Tool Configuration，配置 JDK、Git、Maven 等工具路径，使流水线/任务可直接调用。
- 源码与凭据：在 Manage Jenkins → Manage Credentials 添加 SSH 私钥/用户名密码，在任务中配置 Git 仓库 URL 与凭据，确保拉取代码权限正确。
- 典型验证流程：
- 新建任务（如 Pipeline），在 Pipeline 脚本中使用 git 步骤拉取代码并执行构建命令（如 mvn/./gradlew）。
- 构建后使用 JUnit/HTML Publisher 发布报告，确认插件生效与报告展示正常。
五 常见问题与优化
- 下载慢或超时：在 Manage Jenkins → Manage Plugins → Advanced 配置 Update Site 为国内镜像（如清华/中科大镜像），可显著提升插件下载速度。
- 依赖冲突与版本不兼容：优先使用与当前 Jenkins 版本匹配的插件版本；必要时回退到稳定旧版或使用 CLI 指定版本安装。
- 更新与回滚：在 Installed/Updates 页执行更新；如遇异常，可卸载或回滚到上一个稳定版本，并重启服务。
- 安全与维护：定期更新插件与 Jenkins 版本；禁用不再使用的插件，减少攻击面与资源占用。