TeamCity On-Premises 2024.03 Help

配置重试构建触发器

重试构建触发器会在当前构建配置的上一次构建失败时自动将新的构建添加到队列中。

触发设置

以下设置可用于重试构建触发器:

设置

描述

等待的秒数

指定在将新的构建添加到队列之前要等待的秒数。

尝试重试构建的次数

指定触发器尝试重新运行失败构建的次数。 如果构建未成功,留空则可以无限次重试。

触发一个新的构建,使用相同的修订版本

启用此选项后,重试触发器将使用相同的源修订版重新运行失败的构建。

这个选项有助于识别与构建代码无关的构建问题:例如,如果构建配置中存在不稳定的测试,或者遇到了一些无法预见的代理兼容性问题。
如果带有触发器的构建是构建链的一部分,那么前一个链运行中所有成功的构建都将被重用,所有可能导致依赖构建失败的失败的依赖构建将在相同的修订版本上重建。
如果在自定义构建设定中指定了任何构建参数或评论,它们将被应用到由重试触发器启动的后续构建运行中。

将新触发的构建放到队列顶部

启用此选项后,重试的构建将始终被置于队列顶部。

分支过滤器

branch filter 应用于只在符合指定条件的分支中重新运行失败的构建。

触发构建自定义

触发器设置中的 Build Customization 标签允许配置由此触发器启动的构建的自定义参数。 与 Run Custom Build 对话框类似,它让您可以覆盖 构建参数 的值,并选择是否在构建前清理 检出目录

在此选项卡中,您可以自定义当前构建配置中使用的任何参数的值。 或者,您可以添加一个新的参数,它将仅在由此触发器启动的构建中可用。 如果当前构建对其他构建有快照依赖,这样一个参数也可以用来覆盖依赖构建配置的某个属性:使用这个 reverse.dep.<dependencyBuildID>.<property> 语法。

请注意,如果您在触发器中重新定义了构建参数,然后在 参数 中删除了原始参数,那么它的重新定义值将被转换为触发器自己的纯文本参数。 在定制安全值时,这一点至关重要,因为只有与 "Password" 类型 一起存储时,它们才会被隐藏,如果转化为纯文本,它们将变得可读。

TeamCity 允许以多种方式解决类似的任务,在某些情况下,仍然优先创建不同的构建配置。 例如,如果在同一配置中有太多自定义运行,那么 TeamCity 预测每次构建的确切持续时间可能会更加困难。 如果您需要触发带有大量不同参数的构建,我们建议您创建一个 构建配置模板,并将其用作各种配置的蓝图,每种配置都有其自己的参数。

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