界面与导航 #

本节将详细介绍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视图:

  1. 点击 Open Blue Ocean 进入
  2. 可视化Pipeline流程
  3. 更好的用户体验

视图管理 #

创建新视图 #

  1. 点击首页的 +
  2. 选择视图类型:
    • 列表视图 (List View)
    • 我的视图 (My View)
    • 分类视图 (Categorized View)
  3. 配置视图过滤条件

视图过滤 #

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支持移动端浏览器访问,界面会自动适配。

推荐操作 #

  • 查看构建状态
  • 触发构建
  • 查看控制台输出

界面自定义 #

安装主题插件 #

  1. 安装 Simple Theme Plugin
  2. 配置自定义CSS/JS

示例CSS #

css
#header {
    background-color: #424242;
}

.task-link {
    font-size: 14px;
}

常见问题 #

1. 界面加载缓慢 #

  • 检查网络连接
  • 清理旧构建历史
  • 增加JVM内存

2. 无法显示某些功能 #

  • 检查用户权限
  • 确认插件已安装
  • 刷新页面

3. 中文显示问题 #

  • 安装 Locale Plugin
  • 设置默认语言为中文

下一步学习 #

小结 #

  • 首页显示任务列表和系统状态
  • 侧边栏提供快速导航
  • 系统管理包含所有配置入口
  • 状态图标直观显示构建状态
  • 视图功能帮助组织任务
  • 搜索功能快速定位任务
最后更新:2026-03-28