CentOS环境下Jenkins插件如何管理

CentOS环境下Jenkins插件管理

一 管理入口与常用方式

• 通过 Web 界面：登录 http://<服务器IP>:8080，依次进入 Manage Jenkins → Manage Plugins。在 Available 搜索并勾选插件，点击 Install without restart 或 Download now and install without restart 完成安装；在 Updates 执行更新；在 Installed 执行卸载或禁用。部分操作完成后需要重启 Jenkins 生效。
• 通过 Jenkins CLI：准备 jenkins-cli.jar，使用命令安装/更新/卸载插件，适合批量与自动化。示例：java -jar jenkins-cli.jar -s http:/// install-plugin 。
• 手动离线安装：下载插件的 .hpi/.jpi 文件，Web 端在 Advanced → Upload Plugin 上传；或复制到 $JENKINS_HOME/plugins（常见路径为 /var/lib/jenkins/plugins）后重启。适合无外网或严格离线环境。

二 安装与更新步骤

• 在线安装（Web）
  1. 进入 Manage Jenkins → Manage Plugins → Available，搜索插件名称（如 Git、Pipeline）。
  2. 勾选插件，选择 Install without restart，等待安装完成；如页面提示或插件需要，重启 Jenkins。
  3. 安装后在 Installed 验证是否启用成功。
• 离线安装（Web 上传）
  1. 在插件站点下载 .hpi/.jpi 文件。
  2. 进入 Manage Plugins → Advanced → Upload Plugin，选择文件上传。
  3. 上传完成后重启 Jenkins 使插件生效。
• 离线安装（CLI 或文件复制）
  • CLI：java -jar jenkins-cli.jar -s http:/// install-plugin .hpi（可叠加 -restart 自动重启）。
  • 文件复制：将 .hpi 放到 /var/lib/jenkins/plugins，重启 Jenkins。
• 更新插件
  • Web：进入 Updates，勾选需要更新的插件，点击 Update，按提示重启。
  • CLI：java -jar jenkins-cli.jar -s http:/// update-plugin 。
• 常用验证
  • 在 Installed 查看插件状态与版本；执行一次构建或打开相关功能页面确认可用。

三 卸载与禁用

• 卸载（Web）：在 Installed 选择插件并执行 Uninstall，按提示重启。
• 卸载（手动）：删除 /var/lib/jenkins/plugins/.hpi 或对应目录，重启 Jenkins。注意：被其他插件依赖的插件不可直接卸载，需先处理依赖关系。
• 禁用：在 Installed 取消勾选对应插件实现禁用，无需删除文件，适合临时关闭功能。

四 网络与镜像优化

• 配置代理：在 Manage Jenkins → Manage Plugins → Advanced 设置 HTTP Proxy，解决内网访问受限问题。
• 切换更新源为国内镜像：将插件更新站点改为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json，并更新 updateSite 配置（如 /etc/sysconfig/jenkins 或 /etc/default/jenkins 中的相关项），重启 Jenkins 后生效。
• 直接替换更新元数据：在 /var/lib/jenkins/updates/ 下更新 default.json 中的下载 URL 为镜像地址，可显著加速插件列表与文件下载。

五 目录结构与常用命令

• 关键目录与文件

• 常用命令
  • 重启服务：sudo systemctl restart jenkins
  • 查看状态：sudo systemctl status jenkins
  • CLI 安装插件：java -jar jenkins-cli.jar -s http:/// install-plugin [-restart]
  • CLI 更新插件：java -jar jenkins-cli.jar -s http:/// update-plugin
  • CLI 卸载插件：java -jar jenkins-cli.jar -s http:/// uninstall-plugin
• 注意事项
  • 操作前备份 $JENKINS_HOME（至少备份 plugins/ 与 updates/）。
  • 插件需与当前 Jenkins 版本兼容；更新或回滚前建议在测试环境验证。
  • 批量变更（安装/更新/卸载）后统一重启，减少频繁启停带来的不稳定。