Jenkins在Linux如何管理插件

Linux 上管理 Jenkins 插件的完整指南

一管理入口与常用操作

通过 Web 界面：登录 http://<服务器IP>:8080 → Manage Jenkins → Manage Plugins。在 Available 选项卡搜索并勾选插件，选择 Install without restart 或 Install and restart；在 Updates 选项卡执行更新；在 Installed 选项卡对已安装插件执行 Uninstall。为降低风险，更新时优先使用“安装完成后重启（空闲时）”的安全重启方式。
通过 Jenkins CLI：下载 jenkins-cli.jar（地址 http://<JENKINS_URL>/jnlpJars/jenkins-cli.jar），使用方式与示例见下文。注意 CLI 的版本需与 Jenkins 版本匹配，避免兼容性问题。
手动安装与卸载：适用于离线环境或更新中心不可达时，下载 .hpi/.jpi 插件包，通过 Web 界面 Advanced → Upload Plugin 上传，或复制到插件目录后重启；卸载可在 Web 界面执行，或手动清理插件目录后重启。

二命令行与手动方式速查

准备 CLI：
- 下载：wget http://<JENKINS_URL>/jnlpJars/jenkins-cli.jar
- 帮助：java -jar jenkins-cli.jar -s http://<JENKINS_URL>/ -auth user:token_or_pass help
常用命令（HTTP 方式，需 -auth；SSH 方式见下一节）：
- 安装：java -jar jenkins-cli.jar -s http://<JENKINS_URL>/ -auth user:token install-plugin <plugin-id|plugin.hpi>
- 更新：java -jar jenkins-cli.jar -s http://<JENKINS_URL>/ -auth user:token update-plugin
- 卸载：java -jar jenkins-cli.jar -s http://<JENKINS_URL>/ -auth user:token uninstall-plugin
- 列出插件：java -jar jenkins-cli.jar -s http://<JENKINS_URL>/ -auth user:token list-plugins
- 安全重启：java -jar jenkins-cli.jar -s http://<JENKINS_URL>/ -auth user:token safe-restart
手动方式要点：
- 插件目录：Linux 常见路径为 /var/lib/jenkins/plugins/（插件目录为插件 ID 命名的文件夹）。将 .hpi/.jpi 放入该目录后执行：sudo systemctl restart jenkins。
- 上传方式：Web 界面 Manage Plugins → Advanced → Upload Plugin 选择本地 .hpi/.jpi 文件上传，按提示重启。

三插件目录与文件注意事项

默认插件目录为 /var/lib/jenkins/plugins/；每个插件以插件 ID 为目录名存放代码与依赖。手动删除或替换插件文件前务必做好备份，并在操作后重启 Jenkins 使其生效。
手动安装时，优先使用 .hpi/.jpi 文件；若通过 Web 上传或 CLI 安装，Jenkins 会自动处理依赖关系。遇到依赖冲突或安装失败时，优先在 Web 界面查看报错详情。

四加速下载与常见问题处理

加速插件下载：
- 修改更新中心镜像源（如将 default.json 中的更新站点替换为国内镜像），可显著提升下载速度。修改前建议备份原始文件，并在修改后重启 Jenkins 使其生效。
主机无法连接更新中心：
- 离线环境可先在有网环境下载 .hpi/.jpi，再通过 Upload Plugin 或复制到 /var/lib/jenkins/plugins/ 后重启完成安装。
证书验证错误与版本兼容：
- 若出现 证书验证错误，检查 JAVA_HOME/CA 证书 与系统时间；必要时使用可信镜像源。
- 升级 Jenkins 后，请同步使用对应版本的 jenkins-cli.jar，避免 CLI 兼容性问题。

五最佳实践

最新问答