配置重试构建触发器
重试构建触发器会在当前构建配置的上一次构建失败时自动将新的构建添加到队列中。
note
要在 Kotlin DSL 中配置 retry build trigger,请参见 RetryBuildTrigger。
以下设置可用于重试构建触发器:
设置 | 描述 |
---|---|
等待的秒数 | 指定在将新的构建添加到队列之前要等待的秒数。 |
尝试重试构建的次数 | 指定触发器尝试重新运行失败构建的次数。 如果构建未成功,留空则可以无限次重试。 |
触发一个新的构建,使用相同的修订版本 | 启用此选项后,重试触发器将使用相同的源修订版重新运行失败的构建。 这个选项有助于识别与构建代码无关的构建问题:例如,如果构建配置中存在不稳定的测试,或者遇到了一些无法预见的代理兼容性问题。 |
将新触发的构建放到队列顶部 | 启用此选项后,重试的构建将始终被置于队列顶部。 |
分支过滤器 | 将 branch filter 应用于只在符合指定条件的分支中重新运行失败的构建。 |
触发器设置中的 Build Customization 标签允许配置由此触发器启动的构建的自定义参数。 与 Run Custom Build 对话框类似,它让您可以覆盖 构建参数 的值,并选择是否在构建前清理 检出目录。
在此选项卡中,您可以自定义当前构建配置中使用的任何参数的值。 或者,您可以添加一个新的参数,它将仅在由此触发器启动的构建中可用。 如果当前构建对其他构建有快照依赖,这样一个参数也可以用来覆盖依赖构建配置的某个属性:使用这个 reverse.dep.<dependencyBuildID>.<property>
语法。
tip
如果您将此功能与 build step execution conditions 结合使用,效果会更好。 您只需向步骤添加一个基于参数的条件,然后配置两个触发器:一个将运行包含此步骤的构建(条件满足时),另一个则会运行不包含此步骤的构建。 一种常见的用例是在常规构建中运行有限的测试,但在夜间构建中,当服务器负载最低时,运行完整的测试集。
请注意,如果您在触发器中重新定义了构建参数,然后在 参数 中删除了原始参数,那么它的重新定义值将被转换为触发器自己的纯文本参数。 在定制安全值时,这一点至关重要,因为只有与 "Password" 类型 一起存储时,它们才会被隐藏,如果转化为纯文本,它们将变得可读。
TeamCity 允许以多种方式解决类似的任务,在某些情况下,仍然优先创建不同的构建配置。 例如,如果在同一配置中有太多自定义运行,那么 TeamCity 预测每次构建的确切持续时间可能会更加困难。 如果您需要触发带有大量不同参数的构建,我们建议您创建一个 构建配置模板,并将其用作各种配置的蓝图,每种配置都有其自己的参数。
感谢您的反馈!