Blue Ocean 入门

本节将介绍如何开始使用BlueOcean。介绍如何 安装和配置Blue Ocean进入Blue Ocean UI返回 Jenkins 经典 UI.

安装 Blue Ocean

Blue Ocean 可以用以下方式安装:

在已有Jenkins实例上安装

在大多数平台安装Jenkins时,默认情况下不安装Blue Ocean 插件 及其所有其他依赖插件(组成Blue Ocean“插件套件”)。

要在现有的Jenkins实例上安装Blue Ocean插件套件,您的Jenkins实例必须运行Jenkins 2.7.x或更高版本。

任何拥有 Administer 权限(通过 基于Matrix 安全设置)的Jenkins用户都可以在Jenkins实例上安装插件 。拥有次权限的Jenkins用户还可以配置系统上其他用户的权限。在管理安全性授权 部分了解更多信息

要将Blue Ocean安装到您的Jenkins实例:

  • 如果需要,请确保您已经登录到jenkins(作为具有管理员 权限的用户).

  • 从Jenkins主页(即Jenkins经典用户界面的仪表板),单机左侧的 管理Jenkins ,然后单击中心的 管理插件

  • 点击 可用的 选项卡,然后在 过滤 文本框键入 blue ocean ,将过两次插件列表为名称/描述包含“blue”和“ocean”的插件名单。

Blue Ocean plugins filtered

  • 选择 安装 列顶部附近的 Blue Ocean 插件复选框,然后单击 立刻下载并在重启后安装 按钮(推荐)或 安装而不重新启动按钮注意:
  • 无需选择此过滤列表中其他插件的复选框,因为 Blue Ocean 插件具有其他插件的依赖关系(构成Blue Ocean的插件套件),当您点击安装,其他插件将被自动选择和安装。

  • 如果你选择 安装不重启 按钮, 你可能需要重启Jenkins来获取Blue Ocean的完整功能。

阅读管理 插件 页面中有关如何安装和管理插件的更多信息 。

Blue Ocean 在安装后不需要额外的配置,现有的pipeline 和其他项目(如自由风格作业)将照常运行。

但是,请注意, 首次使用特定的 Git 服务(即GitHub,Bitbucket或普通Git服务器)在Blue Ocean中创建pipeline 时,Blue Ocean会提示您输入credentials以访问Git服务器上的存储库。在Blue Ocean可以将 Jenkinsfile 写入存储库之前

作为Jenkins-Docker镜像的一部分

Blue Ocean套件也与Jenkins捆绑在一起,作为Jenkins Docker镜像(jenkinsci/blueocean)的一部分,该镜像可以从 Docker Hub 存储库获得。

参阅安装 Jenkins 页面的Docker 部分获取更多信息

访问 Blue Ocean

一旦Jenkins环境安装了Blue Ocean,登录到Jenkins经典UI 后,您可以通过点击左侧的 打开Blue Ocean 来访问Blue Ocean页面。

Open Blue Ocean link

或者,您可以在您的Jenkins url后面追加 /blue 直接访问Blue Ocean - 如 http://jenkins-server-url/blue.

如果您的Jenkins实例:

  • 已经存在pipeline或其他项目,则显示Blue Ocean 仪表板

  • 是新的或者没有配置项目,则Blue Ocean 会显示 Welcome to Jenkins 对话框,其中包含了 Create a new Pipeline 按钮。您可以使用该按钮开始创建新的pipeline 项目。参阅 创建 Pipeline获取更多信息

_Welcome to Jenkins - Create a New Pipeline message box_

导航栏

Blue Ocean 用户界面顶部有一个导航栏,可以让您访问Blue Ocean 的不同视图和其他功能。

导航栏分为两部分 - 占据了Blue Ocean视图顶部大部分的公共部分和下面的上下文相关部分。上下文部分取决于您正在查看的Blue Ocean界面。

导航栏的公共部分包含以下按钮:

  • Jenkins 图标 - 点击返回 Dashboard,如果您正在该页面,则重新加载。

  • Pipelines - 也会将您带到仪表板,如果您已经在查看仪表板,则不会执行任何操作。 当您查看 Pipeline 运行细节 页面时,此按钮有不同的用途。

  • Administration - 点击进入经典UI的 管理Jenkins 页面注意: 如果您的Jenkins用户没有Administer 权限 (通过 基于Matrix安全性设置). 参阅 管理 安全性授权 部分获取更多信息

  • Go to classic 图标 - 点击返回经典Jenkins界面。 参阅 切换到经典界面获取更多信息

  • Logout - 注销当前Jenkins用户并返回Jenkins登录界面

使用标准导航栏的视图会在其下方添加另一栏,并带有该视图特定的选项。一些视图将普通的导航栏替换为特别适合该视图的导航栏。

切换到经典界面

Blue Ocean 不支持一些用户需要的Jenkins遗留或管理的功能。

如果您需要放弃Blue Ocean用户体验来访问这些功能,请单击Blue Ocean navigation bar公共部分顶部的 转到经典图标。

Go to classic icon

点击此按钮即可进入Jenkins经典用户界面的等效界面,或者Blue Ocean中与经典界面最相似的界面