编辑“︁Jenkins BlueOcean界面”︁

= Jenkins BlueOcean界面 =

== 介绍 ==
'''Jenkins BlueOcean''' 是 Jenkins 的一个现代化用户界面插件，旨在简化持续集成和持续交付（CI/CD）流程的可视化与管理。它提供了直观的图形化界面，特别适合初学者快速理解流水线的执行状态，同时也为高级用户提供了更清晰的调试和监控工具。BlueOcean 重新设计了传统的 Jenkins 界面，强调流水线的可视化、实时反馈和交互性。

主要特点包括：
* 图形化流水线展示
* 实时日志查看
* 分支和拉取请求的集成
* 更直观的错误诊断

== 安装与配置 ==
=== 前提条件 ===
* 已安装 Jenkins（建议版本 2.346.1 或更高）
* 管理员权限

=== 安装步骤 ===
1. 登录 Jenkins 控制台。
2. 导航到 '''Manage Jenkins > Manage Plugins'''。
3. 在 "Available" 选项卡中搜索 "BlueOcean"。
4. 勾选插件并点击 "Install without restart"（或 "Download now and install after restart"）。

安装完成后，BlueOcean 界面会作为独立入口出现在 Jenkins 主界面。

== 核心功能 ==
=== 流水线可视化 ===
BlueOcean 将传统的文本式流水线转换为交互式图形，每个阶段（Stage）和步骤（Step）以卡片形式展示，颜色标识状态（绿色-成功，红色-失败，蓝色-进行中）。

<mermaid>
graph LR
    A[开始] --> B[阶段1: 代码检出]
    B --> C[阶段2: 构建]
    C --> D[阶段3: 测试]
    D --> E[阶段4: 部署]
</mermaid>

=== 实时日志 ===
点击任意步骤可展开实时日志，支持关键字高亮和日志过滤。例如：
<syntaxhighlight lang="groovy">
pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }
    }
}
</syntaxhighlight>

执行后日志会显示 Maven 构建的详细输出。

=== 分支与PR集成 ===
自动检测 Git 仓库的分支和拉取请求（PR），并为每个分支生成独立的流水线视图。支持 GitHub、Bitbucket 和 GitLab。

== 实际案例 ==
=== 场景：Node.js 项目流水线 ===
以下是一个使用 BlueOcean 监控的简单 Node.js 项目流水线：

<syntaxhighlight lang="groovy">
pipeline {
    agent any
    stages {
        stage('Install') {
            steps {
                sh 'npm install'
            }
        }
        stage('Test') {
            steps {
                sh 'npm test'
            }
        }
        stage('Deploy') {
            when {
                branch 'main'
            }
            steps {
                sh 'npm run deploy'
            }
        }
    }
}
</syntaxhighlight>

在 BlueOcean 中的表现：
1. 三个阶段以横向流程条展示
2. 点击 "Test" 阶段可查看 Jest 测试结果
3. "Deploy" 阶段仅在 main 分支执行（通过条件语句 <code>when { branch 'main' }</code> 控制）

=== 错误诊断示例 ===
当测试失败时：
1. BlueOcean 会高亮显示失败的阶段（红色）
2. 展开日志可看到具体失败的测试用例
3. 提供 "Re-run" 按钮快速重试

== 高级技巧 ==
=== 自定义视图 ===
通过 Jenkinsfile 的 <code>options</code> 指令定制 BlueOcean 显示：
<syntaxhighlight lang="groovy">
pipeline {
    options {
        timestamps()
        disableConcurrentBuilds()
    }
    // 其他配置...
}
</syntaxhighlight>

=== 性能指标 ===
BlueOcean 展示每个阶段的持续时间，可通过公式计算效率：
<math>
Efficiency = \frac{Successful\ Builds}{Total\ Builds} \times 100\%
</math>

== 常见问题 ==
{| class="wikitable"
|-
! 问题 !! 解决方案
|-
| BlueOcean 不显示某些流水线 || 确保流水线使用 Declarative 语法（而非 Scripted）
|-
| 图形渲染错位 || 清除浏览器缓存或尝试禁用浏览器扩展
|-
| 缺少 Git 集成选项 || 确认已安装对应 SCM 插件（如 GitHub Branch Source）
|}

== 总结 ==
Jenkins BlueOcean 通过以下方式提升 CI/CD 体验：
* 降低新手学习曲线
* 加速故障定位
* 统一多分支管理
* 提供企业级可视化

建议结合经典界面使用，BlueOcean 特别适合：
* 快速验证新流水线
* 团队协作演示
* 复杂流水线的调试

[[Category:集成部署]]
[[Category:Jenkins]]
[[Category:Jenkins流水线]]