TeamCity On-Premises 2024.03 Help

TeamCity Sakura 用户界面

Sakura用户界面,首次在 TeamCity 2019.1 中作为传统用户界面的替代品引入,现在已经成为 TeamCity 的默认用户界面。 虽然经典的用户界面仍然可用并得到维护,但新产品的功能将只在 Sakura UI 中得到支持。

我们建议您使用 Sakura UI,这是一个注重可访问性的全新现代界面,带来更多益处。 这个新的 UI 正在积极开发中,我们欢迎您的 反馈

启用和禁用 Sakura UI

当您首次登录 TeamCity 时,默认启用 Sakura UI。

如果您之前使用的是经典界面,在升级 TeamCity 后,系统会提议您切换到 Sakura 界面,并且会记住您的选择。

您可以通过勾选 使用 Sakura UI 复选框,在 Your Profile | UI settings 中更改默认的 UI。

所有支持新 UI 的页面都有一个切换开关,方便快速访问经典 UI:切换至经典用户界面

要返回 Sakura UI,请点击魔术棒图标:切换至 Sakura UI

以下部分提供了 Sakura UI 和经典的 TeamCity UI 之间的差异概述。

Sakura UI 的功能

新的用户界面附带了一个方便的 侧边栏 ,用于快速导航。

目前,Sakura UI 可用于以下页面:

在下面,您将找到这些功能的回顾。

樱花侧边栏

这个改进后的侧边栏显示了项目层次结构,在 Agents 页面中,显示出代理层次结构并有助于更好地在项目、构建配置或构建代理之间导航。

您可以通过拖动其框架边框来更改侧边栏的宽度,通过点击其底部的相应按钮来随时隐藏/显示它。

要定制侧边栏,点击其右上角的 wn-pencil.png。 在自定义菜单中,您可以通过键盘或使用箭头 UI 按钮,在列表中移动项目或构建配置,或者标记/取消标记项目作为您的收藏。

项目侧边栏

Projects 侧边栏列出了当前 TeamCity 用户可用的所有项目,并允许通过名称进行搜索。 您可以展开任何项目以查看其嵌套的子项目/构建配置,并快速在它们之间切换。 所有嵌套对象的状态图标和计数器也在侧边栏中显示。

Sakura 项目 sidefar

侧边栏允许访问您喜欢的 项目 视图和 构建 视图,分别显示您喜欢的项目和喜欢的构建配置的列表。
您还可以切换显示已存档项目。

您可以使用 Q 键盘快捷键,将焦点聚焦在项目的搜索字段上。 当聚焦时,使用 键盘箭头在搜索结果之间导航。 要移除焦点,请按 Esc

樱花项目主页

概览选项卡位于项目主页,它提供了项目的子项目和构建配置的更多可视信息。 该页面有两个主要视图:BuildsTrends

Trends 视图包括代表所选项目的构建配置的卡片。

樱花项目趋势页面

每张卡片都包含了最新构建的预览,以时间轴上的条形图展示。 您可以将鼠标悬停在任何条形图上,即可立即查看有关构建的更多信息:其持续时间、队列统计、测试结果、使用的代理等等。 该卡片还显示了待处理更改的数量。

project-trends.gif

Builds 视图与经典 UI 相似,显示了当前项目的子项目和构建配置中最近的构建列表。

project-builds.png

Sakura 构建配置主页

Sakura Build Configuration Home 页面的 Overview 标签提供了两种视图:

  • 分支,列出活动分支中的最近构建

    bc-branches.png

  • 构建,列出了该配置的所有最近的构建

    bc-builds-history.png

列表中的每个构建项都是可展开的:点击它以预览构建的最重要信息,并快速访问任何一个 构建结果 标签。

点击特定的构建问题或失败的测试以查看相关的堆栈跟踪:

build-test-stacktrace.png

点击 在构建日志中打开 ,将直接在出现问题的行打开新的构建日志。

Changes 弹出框分别按照历史顺序和来源展示构建更改:用户对代码的提交和对制品依赖性的更改。 您也可以通过更改的作者来过滤更改,并显示在构建配置设置中所做的更改。

Changes 弹出框的示例:

樱花更改弹出窗口

Sakura 构建结果页面

这个页面可视化构建结果,并提供了几个便捷的小部件。

Actions菜单提供了几个方便的选项:

build-actions.png

概览选项卡

在右上角,您可以查看当前构建配置的前几次构建的趋势。 将鼠标悬停在柱形图上会弹出一个显示构建详细信息的弹窗。

构建趋势预览

交互式图形时间线反映了每个构建阶段的持续时间,并在出现构建问题时进行提示:

构建时间线

点击任何阶段以打开构建日志的相应行。 长日志也可以直接在预览中显示,无需下载。

更改"标签页

Changes选项卡会分别显示有关构建中用户提交和工件更改的更多信息。 您可以按照作者过滤更改,并显示在构建配置设置中所做的更改。

build-changes.png

测试"选项卡

Tests 标签页允许在失败的、被忽略的和成功的测试中切换。 点击一个测试以快速查看其详细信息,或者,例如,分配一个调查。 您也可以在新的 测试历史 页面查看其历史记录。

Test History 页面的性能现在已经有所提升。 它还有一个可调范围滑块,允许您选择将在下方显示的测试历史期间。 测试时间轴是可交互的:

build-test-history.gif

运行此测试的构建列表现在具有更好的可用性:点击构建后,会显示 stacktrace。

依赖性标签页

Dependencies选项卡炫耀其新的更易于使用的设计。

它提供了三种显示构建依赖关系的替代模式:可视化时间线,结构化列表和构建链。 选择最适合您当前任务的模式。

互动时间线显示了此管道中的构建序列和每次构建的持续时间。 它具有可调整的范围滑块,让您可以选择管道的构建版本。

dependencies-timeline.png

列表是构建的平面线,其中也包含许多交互功能:您可以点击并展开构建线并查看结果。

dependencies-list.png

链页面加载更快,并更清晰地展示了构建依赖性。

dependencies-chains.png

樱花代理页面

Sakura Agents 页面能够更快地为大量代理加载并允许快速切换代理详细信息。

该页面提供了更佳的 agent pools 层次视图,并使得查看其所有分配的项目和 cloud images 更为简易。

All Agents 视图提供了所有代理状态的快速预览,并允许您在单一的仪表板上并行管理它们。

您可以编辑 代理池s 的范围,并快速为其分配 agents 和项目。

要编辑代理池,请在其设置中点击 分配代理。 在此对话框中,您可以选择您想要指派到资源池的代理:

在新版 TeamCity 用户界面中编辑代理池

请注意,每当您选择一个云镜像时,您实际上都会将它的所有实例分配给资源池。 如果此池的代理插槽有限制,每个云实例将占用一个插槽,就像任何常规代理一样。

同样,您也可以将项目关联到此池中:打开池设置中的 项目 标签页并点击 分配项目。 这样,分配给此池的代理将只允许在所选项目中运行构建。

代理侧边栏

Agents 侧边栏允许浏览代理池层次结构,包括云配置文件,并通过名称搜索代理和池。 概览视图提供了服务器上所有代理的统计信息。

agents-sidebar-overview.png

樱花更改页面

Sakura 变更页面配有过滤器,提供灵活的搜索选项,允许您按评论(提交信息)、更改文件的路径和修订号对变更进行排序。

changes-page.png

Sakura 队列页面

在此页面上,您可以查看构建在队列中的位置,并查看排队构建的详细信息:

Sakura 构建队列

插件 API

Sakura UI 扩展了 TeamCity 插件 API,并提供了一套 方便的工具以创建插件。

plugin-api-qodana.png

最后修改日期: 16日 7月 2024年