界面与导航 #
本节将详细介绍Jenkins的界面布局和功能导航,帮助你快速熟悉Jenkins的操作界面。
界面概览 #
首页布局 #
text
┌─────────────────────────────────────────────────────────────┐
│ Jenkins [登录用户] [设置] [帮助]│
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ 任务列表 │ │
│ │ ┌────────────────────────────────────────────────┐ │ │
│ │ │ 任务名称 状态 最后成功 最后失败 操作 │ │ │
│ │ ├────────────────────────────────────────────────┤ │ │
│ │ │ hello-world ✓ #5 2分钟前 - [▼] │ │ │
│ │ │ my-pipeline ✗ #3 1小时前 30分钟前 [▼] │ │ │
│ │ └────────────────────────────────────────────────┘ │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ 构建队列 │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ 构建执行器状态 │ │
│ │ #1: hello-world #5 #2: 空闲 #3: 空闲 │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
顶部导航栏 #
左侧区域 #
| 元素 | 说明 |
|---|---|
| Jenkins Logo | 点击返回首页 |
| 任务名称 | 显示当前任务名称(任务页面) |
右侧区域 #
| 元素 | 说明 |
|---|---|
| 搜索框 | 快速搜索任务 |
| 用户名 | 当前登录用户 |
| 通知 | 系统通知 |
| 设置 | 系统设置入口 |
| 帮助 | 文档和帮助链接 |
侧边栏菜单 #
首页侧边栏 #
text
├── 新建任务 (New Item)
├── 用户列表 (People)
├── 构建历史 (Build History)
├── 项目关系图 (Build Queue)
├── 检查代码风格 (Check File Fingerprint)
└── 系统管理 (Manage Jenkins)
任务页面侧边栏 #
text
├── 返回首页 (Back to Dashboard)
├── 状态 (Status)
├── 变更记录 (Changes)
├── 工作空间 (Workspace)
├── 构建历史 (Build History)
├── 流水线概览 (Pipeline Overview)
├── 配置 (Configure)
├── 删除任务 (Delete Project)
└── 其他操作...
构建页面侧边栏 #
text
├── 返回任务 (Back to Project)
├── 状态 (Status)
├── 变更记录 (Changes)
├── 控制台输出 (Console Output)
├── 编辑构建信息 (Edit Build Information)
├── 删除构建 (Delete build)
└── 其他操作...
系统管理页面 #
访问路径 #
Manage Jenkins → 系统管理页面
常用功能 #
系统配置 #
| 功能 | 说明 |
|---|---|
| System | 系统全局配置 |
| Global Tool Configuration | 全局工具配置 |
| Configure Credentials | 凭据管理 |
| Configure Global Security | 全局安全配置 |
任务管理 #
| 功能 | 说明 |
|---|---|
| Manage Nodes and Clouds | 节点和云管理 |
| Manage Plugins | 插件管理 |
数据管理 #
| 功能 | 说明 |
|---|---|
| Reload Configuration from Disk | 重新加载配置 |
| System Log | 系统日志 |
系统信息 #
| 功能 | 说明 |
|---|---|
| System Information | 系统信息 |
| Jenkins CLI | 命令行工具 |
| Script Console | 脚本控制台 |
任务状态图标 #
构建状态 #
| 图标 | 状态 | 说明 |
|---|---|---|
| ☀️ | 成功 | 构建成功 |
| ⚡ | 失败 | 构建失败 |
| ⏸️ | 中止 | 构建被中止 |
| ⏳ | 进行中 | 构建进行中 |
| ❓ | 未构建 | 从未构建 |
天气图标 #
| 图标 | 说明 |
|---|---|
| ☀️ | 80-100% 成功率 |
| 🌤️ | 60-79% 成功率 |
| 🌥️ | 40-59% 成功率 |
| 🌧️ | 20-39% 成功率 |
| ⛈️ | 0-19% 成功率 |
任务操作菜单 #
点击任务名称旁的下拉箭头,显示操作菜单:
text
├── 立即构建 (Build Now)
├── 配置 (Configure)
├── 工作空间 (Workspace)
├── 最近变更 (Recent Changes)
├── 流水线步骤 (Pipeline Steps)
├── 查看配置 (View Configuration)
├── 复制任务 (Copy)
├── 重命名 (Rename)
└── 删除 (Delete)
构建历史视图 #
列表视图 #
显示构建历史列表:
text
#5 ✓ 成功 2分钟前 admin 10秒
#4 ✓ 成功 1小时前 admin 12秒
#3 ✗ 失败 2小时前 admin 8秒
#2 ✓ 成功 3小时前 admin 11秒
#1 ✓ 成功 1天前 admin 15秒
趋势图 #
显示测试结果趋势:
text
测试结果趋势
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
通过: ████████████████████████ 95%
失败: ██ 5%
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
工作空间视图 #
访问工作空间 #
任务页面 → Workspace
功能 #
- 浏览文件结构
- 查看文件内容
- 下载文件
text
workspace/
├── src/
│ └── main/
│ └── java/
├── target/
│ ├── classes/
│ └── myapp.jar
├── pom.xml
└── README.md
Pipeline视图 #
Stage View #
显示Pipeline各阶段状态:
text
┌─────────┬─────────┬─────────┬─────────┐
│ Checkout│ Build │ Test │ Deploy │
│ ✓ │ ✓ │ ✓ │ ✓ │
│ 2.3s │ 15.6s │ 45.2s │ 8.1s │
└─────────┴─────────┴─────────┴─────────┘
Blue Ocean #
现代化Pipeline视图:
- 点击 Open Blue Ocean 进入
- 可视化Pipeline流程
- 更好的用户体验
视图管理 #
创建新视图 #
- 点击首页的 + 号
- 选择视图类型:
- 列表视图 (List View)
- 我的视图 (My View)
- 分类视图 (Categorized View)
- 配置视图过滤条件
视图过滤 #
text
Recurse in subfolders: ✓
Status Filter: All
Include Pattern: myapp-*
Exclude Pattern: test-*
搜索功能 #
快速搜索 #
在搜索框输入关键词:
text
搜索任务名称
搜索任务描述
搜索构建历史
高级搜索 #
text
type:pipeline 搜索Pipeline任务
status:failed 搜索失败构建
用户偏好设置 #
访问路径 #
点击用户名 → Settings
可配置项 #
- 时区设置
- 语言设置
- 外观主题
- 通知设置
快捷键 #
| 快捷键 | 功能 |
|---|---|
/ |
聚焦搜索框 |
g + h |
返回首页 |
g + m |
系统管理 |
? |
显示帮助 |
移动端访问 #
响应式设计 #
Jenkins支持移动端浏览器访问,界面会自动适配。
推荐操作 #
- 查看构建状态
- 触发构建
- 查看控制台输出
界面自定义 #
安装主题插件 #
- 安装 Simple Theme Plugin
- 配置自定义CSS/JS
示例CSS #
css
#header {
background-color: #424242;
}
.task-link {
font-size: 14px;
}
常见问题 #
1. 界面加载缓慢 #
- 检查网络连接
- 清理旧构建历史
- 增加JVM内存
2. 无法显示某些功能 #
- 检查用户权限
- 确认插件已安装
- 刷新页面
3. 中文显示问题 #
- 安装 Locale Plugin
- 设置默认语言为中文
下一步学习 #
小结 #
- 首页显示任务列表和系统状态
- 侧边栏提供快速导航
- 系统管理包含所有配置入口
- 状态图标直观显示构建状态
- 视图功能帮助组织任务
- 搜索功能快速定位任务
最后更新:2026-03-28