CentOS 上 Jenkins 插件的安装与配置
一 管理入口与常用操作
- 登录控制台：访问 http://<服务器IP>:8080，进入 Manage Jenkins → Manage Plugins。
- 在线安装：在 Available 搜索并勾选所需插件，点击 Install without restart；部分插件需重启生效。
- 更新与卸载：在 Updates 执行更新；在 Installed 选择 Uninstall 后重启。
- 离线安装：在 Advanced → Upload Plugin 上传 .hpi/.jpi 文件，完成后重启。
- 代理与网络：在 Advanced → Proxy Settings 配置 HTTP/HTTPS 代理，解决内网环境下载问题。
二 切换国内插件源与离线安装
- 界面方式：在 Manage Plugins → Advanced 将 Update Site 改为清华镜像 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json，保存后重启并重新检查更新。
- 文件方式：替换更新站点定义文件
- 路径：/var/lib/jenkins/updates/default.json
- 命令示例：
- sed -i ‘s|http://updates.jenkins-ci.org/download|https://mirrors.tuna.tsinghua.edu.cn/jenkins|g’ /var/lib/jenkins/updates/default.json
- sed -i ‘s|http://www.google.com|https://www.baidu.com|g’ /var/lib/jenkins/updates/default.json
- 重启：systemctl restart jenkins
- 离线批量安装：
- 将插件目录（如 .jenkins/plugins/）拷贝到 /var/lib/jenkins/plugins/，覆盖前先备份原目录。
- 重启：systemctl restart jenkins。
三 常用插件与用途
- Git：拉取代码；Maven Integration：提供“构建一个 Maven 项目”任务类型。
- GitLab：与 GitLab 集成；Publish Over SSH：构建后通过 SSH 分发到远程主机。
- Pipeline：流水线即代码；Credentials Binding：凭据安全绑定；Blue Ocean：现代化 UI。
四 安装后的关键配置
- 全局工具配置：进入 Manage Jenkins → Global Tool Configuration，设置 JDK、Maven、Git 的安装路径（如使用系统已装 JDK/Maven，填写其 JAVA_HOME/M2_HOME）。
- Git 凭据与缓存：在 Manage Jenkins → Manage Credentials 添加 Username with password/SSH key；必要时在 Jenkins 节点执行 git config --global credential.helper store 保存凭据。
- GitLab 连接：在 Manage Jenkins → System → GitLab 填写 GitLab host URL，用 GitLab API token 创建凭据并 Test Connection。
- Publish Over SSH：在 系统设置 配置 SSH Servers（Hostname、Port、Credentials），在 Job 的构建后操作中使用 Send build artifacts over SSH。
- 全局属性：在 Manage Jenkins → Configure System → Global Properties 添加 JAVA_HOME、M2_HOME、PATH+EXTRA，便于 Job 统一环境。
五 常见问题与排障
- 插件下载慢或失败：切换 清华镜像源 或配置 代理；必要时使用 离线 .hpi 安装。
- 安装后功能未出现：重启 Jenkins（如 systemctl restart jenkins），部分插件需重启才注册扩展点。
- 节点无法解析 GitLab 域名：检查 DNS/hosts 或在 Jenkinsfile 中使用可达的 IP/内网域名。
- 权限与目录：确保 Jenkins 用户对 /var/lib/jenkins 及子目录有读写权限；离线拷贝插件后注意文件属主与权限一致。