Ubuntu Jenkins部署如何配置插件
小樊
37
2025-11-22 18:54:32
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 。