构建的主要操作

重新运行构建

此操作将仅重新启动当前构建，忽略其 chain中的其他构建（如果有）。 如果构建因某些基础设施问题而失败，可能会有所帮助。

删除构建

此操作将从列表中删除构建。

固定构建

您可以将构建固定，以防止在计划的 清理 期间被移除。

如果当前构建是 chain的一部分，并且对其他构建具有 snapshot dependencies ，您可以选择将此操作应用于链中所有先前的构建。

固定的构建可以在任何时候手动取消固定。

向构建添加标签

构建标签是可以提供帮助的标签：

• 组织您的构建历史。

• 快速导航至带有特定标签的构建。

• 搜索带有特定标签的构建。

• 在具有特定标签的构建上创建一个 工件依赖项。

在 编辑标签 对话框中，输入一个或多个由空格、逗号或分号分隔的标签。 例如， v2022 版本发布 将创建两个标签： v2022 和 release。

如果您在查看构建列表时点击某个标签，系统将会过滤掉其他构建，这样您就可以专注于带有此标签的构建。

除了 操作 菜单，您还可以在 Run Custom Build对话框和 Pin Build对话框中标记构建。

您还可以使用 服务消息 和 TeamCity REST API 添加和修改构建标签。

将 Build 添加到收藏夹

您可以将构建添加到 收藏夹 中，以便快速访问。 喜欢的构建也可以设置为 notifications 的过滤选项。

当添加到收藏夹时，构建将会被标记上一个星形图标 。 点击它将会移除 "favorite" 状态。

TeamCity 可以自动将您手动触发的以及 个人构建 标记为喜欢。 为了实现这一点，请在您的 用户配置设置 中启用相应的设置。

要查看您的收藏，请点击屏幕右上角的头像并选择 收藏生成。

比较两个构建

构建的 操作 菜单中的 Select for comparison操作（在 构建结果 中）仅在新的 TeamCity UI 中可用。 您可以通过点击屏幕右上角的魔术棒图标，从经典UI模式切换至此模式。

此操作允许将当前构建的设置和结果与此构建配置中的任何其他构建进行侧面对比。 它显示了他们的 参数 、修订、统计和测试的统计数据和差异。

当当前的构建配置由多个用户管理和监控时，这种模式尤其有用。 例如，如果一个构建项目中没有代码变更，但却毫无明显原因地失败了，您可以将此构建与最后一次成功的构建进行比较，分析他们的差异，以寻找失败最可能的原因。

手动更改构建状态为失败或成功

项目管理员可以手动将成功构建的状态更改为失败，反之亦然。 以下是此功能的常见使用场景：

• 从成功到失败:

  • 这个构建存在一些问题，虽然没有影响到最终的 build status ，但您希望在构建历史中体现这个问题的存在。

  • 存在一个已知的构建问题，您希望QA团队忽略此构建。

  • 您之前错误地将构建标记为成功。

• 从失败到成功:

  • 您需要在使用 构建失败条件 时更改 最后一次成功构建 的锚点。 如果您的上一次构建失败是因为一个指标的错误值，并且这个新的值是有效的，您可以用一个 成功 锚来标记这次构建。

  • 您希望在 工件依赖项 中允许使用具有良好工件的错误失败构建。

  • 对于正在运行的 个人构建 ，您可以将当前的失败标记为无关紧要，以便允许预测试提交通过。

"Mark as successful" （标记为成功）操作不适用于 无法启动的构建。

构建源标签

TeamCity 可以在您的 VCS 仓库中为特定构建的源文件添加标签（tag）。 已应用标签及其应用状态的列表显示在 更改 选项卡的 构建结果 上。

您可以配置 automatic labeling ，或从 操作 菜单手动为每个构建添加标签。 手动标签使用构建时实际的 VCS 设置。

合并构建源

TeamCity 可将一个源分支的代码合并到另一个分支：例如，经过批准的代码审查后。

您可以配置 automatic merge ，或从 操作 菜单手动为每个构建执行合并。 弹出对话框将提示您选择合并的目标分支，并输入合并提交消息。