Ubuntu Jenkins部署如何配置插件

Ubuntu 上 Jenkins 插件配置全流程

一 准备与入口

• 确保已安装 Java 与 Jenkins，并启动服务：
  • 示例：sudo apt update && sudo apt install openjdk-17-jdk jenkins -y
  • 启动与自启：sudo systemctl start jenkins && sudo systemctl enable jenkins
• 访问 http://<服务器IP>:8080，使用初始密码登录（位于 /var/lib/jenkins/secrets/initialAdminPassword）。
• 进入插件管理：左侧 Manage Jenkins → Manage Plugins。

二 安装插件的方式

• Web UI 在线安装
  • 在 Available 选项卡搜索插件（如 Git、Pipeline、Blue Ocean），勾选后点击 Install without restart 或 Install and restart。
• 命令行 CLI 安装
  • 下载 jenkins-cli.jar，执行：java -jar jenkins-cli.jar -s http://<your-jenkins-url>/ install-plugin <plugin-name>，必要时加 -restart 重启。
• 手动离线安装
  • 从 https://plugins.jenkins.io/ 下载 .hpi/.jpi，复制到 /var/lib/jenkins/plugins/，执行 sudo systemctl restart jenkins 生效。
• 上传插件文件
  • 在 Manage Plugins → Advanced → Upload Plugin 选择 .hpi 上传，随后重启 Jenkins。

三 常用插件与基础配置

• 建议优先安装：Git（源码拉取）、Pipeline（流水线）、Blue Ocean（可视化）、Locale（中文语言包）。
• Git 插件配置要点
  • 在 Manage Jenkins → Global Tool Configuration 配置 Git 可执行路径（如 /usr/bin/git）。
  • 在 Manage Jenkins → Manage Credentials 添加 SSH 私钥 或 用户名/密码，供作业拉取代码使用。
• 中文语言包
  • 安装 Locale plugin 后，在 Manage Jenkins → Configure System 将 Default Language 设为 zh_CN 并勾选 Ignore browser preference and force this language to all users，保存后刷新页面。

四 更新 卸载 禁用与镜像加速

• 更新
  • 在 Manage Plugins → Updates 勾选需要更新的插件，点击 Update，按提示重启。
• 卸载
  • 在 Installed 选项卡选择插件执行 Uninstall，重启后生效；或删除 /var/lib/jenkins/plugins/.hpi 后重启。
• 禁用
  • 在 Installed 选项卡取消勾选插件以禁用（不删除文件，按需再启用）。
• 镜像加速
  • 在 Manage Jenkins → Manage Plugins → Advanced → Update Site 将 URL 替换为国内镜像，例如：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json，保存后点击 Check now 更新索引。

五 常用排障命令

• 重启与状态：sudo systemctl restart jenkins、sudo systemctl status jenkins
• 查看初始密码：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
• 在容器内执行命令（如插件目录检查）：docker exec -it <jenkins-container> bash
• 通过 Web 触发动作（需权限）：/restart、/reload、/exit。