构建的主要操作
这篇文章描述了在 TeamCity 中可以对 builds 应用哪些操作。
运行构建
TeamCity 允许运行构建:
自动地,通过各种 构建触发器。
手动,按需。
要手动运行构建,请在屏幕的右上角点击 Run。 这个操作在构建配置设置和构建配置主页模式下都可用。 如果某个构建配置中未显示 Run 按钮,那就表示您没有足够的权限来启动该构建。
在 Run 按钮旁边的上下文菜单会打开构建的设置菜单,这样您就可以启动 custom build run。 自定义运行允许在当前配置中运行常规构建时,使用不同的设置或/和源代码。 如果您想尝试不同的构建参数或在不影响常见构建设置或将代码提交到公共存储库的情况下,预先测试本地代码,这会很方便。 关于此功能的更多信息,请在 这里 阅读。
取消构建
要取消正在运行的构建,请点击其进度条旁的停止图标。 TeamCity 将提示您输入取消的可选原因;您还可以选择是否应自动将此构建重新添加到队列中。
请注意,没有方法可以暂停然后继续一个单一的构建(尽管您可以暂停整个构建配置)。 如果被取消,应从第一步重新开始构建。
构建操作菜单
以下操作可以从单一构建 Actions 菜单中调用。 要从 Build Configuration Home 打开此菜单,请点击列表中构建的 对面。 要从构建的 概览 中打开它, 请点击左上角的 操作。
重新运行构建
此操作将仅重启当前构建,如果存在,会省略其 chain 中的其他构建。 如果构建因某些基础设施问题而失败,可能会有所帮助。
删除构建
此操作将从列表中删除构建。
固定构建
您可以将构建固定,以防止在计划的 清理 期间被移除。
如果当前构建是链的一部分,并且对其他构建有快照依赖,您可以选择将此操作应用于链中的所有前序构建。
固定的构建可以在任何时候手动取消固定。
向构建添加标签
构建标签是可以提供帮助的标签:
在 编辑标签 对话框中,输入一个或多个由空格、逗号或分号分隔的标签。 例如, v2022 版本发布
将创建两个标签: v2022
和 发布
。
如果您在查看构建列表时点击某个标签,系统将会过滤掉其他构建,这样您就可以专注于带有此标签的构建。
除了 操作 菜单外,您还可以在 运行自定义构建 对话框和 固定构建 对话框中标记一个构建。
您还可以使用 服务消息 和 TeamCity REST API 添加和修改构建标签。
将 Build 添加到收藏夹
您可以将构建添加到 收藏夹 中,以便快速访问。 喜欢的构建也可以设置为 notifications 的过滤选项。
当添加到收藏夹时,构建将会被标记上一个星形图标 。 点击它将会移除 "favorite" 状态。
TeamCity 可以自动将您手动触发的以及 个人构建 标记为喜欢。 为了实现这一点,请在您的 用户配置设置 中启用相应的设置。
要查看您的收藏夹,请点击屏幕右上角的头像,然后选择 Favorite Builds。
比较两个构建
在新的 TeamCity UI 中,只有在构建的 Actions 菜单(在 Build Results 中)中的 Select for comparison 动作才可用。 您可以通过点击屏幕右上角的魔术棒图标,从经典UI模式切换至此模式。
此操作允许将当前构建的设置和结果与此构建配置中的任何其他构建进行侧面对比。 它显示了他们的 参数、修订、统计和测试的统计数据和差异。
当当前的构建配置由多个用户管理和监控时,这种模式尤其有用。 例如,如果一个构建项目中没有代码变更,但却毫无明显原因地失败了,您可以将此构建与最后一次成功的构建进行比较,分析他们的差异,以寻找失败最可能的原因。
手动更改构建状态为失败或成功
项目管理员可以手动将成功构建的状态更改为失败,反之亦然。 以下是此功能的常见使用场景:
从成功到失败:
这个构建存在一些问题,虽然没有影响到最终的 build status,但您希望在构建历史中体现这个问题的存在。
存在一个已知的构建问题,您希望QA团队忽略此构建。
您之前错误地将构建标记为成功。
从失败到成功:
您需要在使用 构建失败条件 时更改 最后一次成功构建 的锚点。 如果您的上一次构建失败是因为一个指标的错误值,并且这个新的值是有效的,您可以用一个 成功 锚来标记这次构建。
您可能希望允许在 Artifact Dependencies 中使用产出良好的构建工件的构建失败。
对于正在运行的个人构建,您可以将当前的失败标记为无关紧要,以便允许预测试提交通过。
将其标记为成功"操作不适用于无法启动的构建。
构建源标签
TeamCity 可以在您的 VCS 仓库中为特定构建的源文件添加标签(tag)。 应用的标签列表及其应用状态会显示在构建结果 的 更改 选项卡上。
您可以在 Actions 菜单中配置 自动标签,或手动标记每个构建。 手动标签使用构建时实际的 VCS 设置。
合并构建源
TeamCity 可将一个源分支的代码合并到另一个分支:例如,经过批准的代码审查后。
您可以在 automatic merge 下配置,或者在每次构建时从 Actions 菜单手动操作。 弹出对话框将提示您选择合并的目标分支,并输入合并提交消息。
构建配置操作菜单
Build Configuration Home 页面有自己的 Actions 菜单,其中包含一组不同的操作。 使用这个平台,您可以:
对多个构建应用操作
您可以同时管理多个构建(例如,固定、添加标签、比较两个构建、移除构建、将构建添加至收藏,或添加评论)。 为此,请在构建配置主页的概览标签页中选择所需的构建(当鼠标悬停在构建上时,复选框会出现),然后使用弹出的上下文菜单中的命令。 如果您需要选择一系列构建,按下 Shift 键并点击要选择的范围边缘的构建复选框。