TeamCity On-Premises 2024.03 Help

添加通知规则

这篇文章解释了如何设置通知规则。 要了解如何在您的 TeamCity 服务器上启用通知功能,请按照 这些说明 操作。

每个通知规则由两部分组成:将监视什么范围以及什么事件将触发通知。 用户可以创建个人规则,并从其用户组中继承规则。

添加通知规则

要添加新的个人通知规则:

  1. 在屏幕的右上角,点击您的头像,然后在下拉菜单中点击 Profile

  2. 您的个人资料中,打开通知规则选项卡。

  3. 点击所需的通知类型并配置所需的设置。

  4. 点击 添加新规则 并在对话框中指定规则。

将被监视的内容

与以下项目和构建配置相关的事件

选择您要监控其构建的项目/构建配置。 为项目定义的通知规则将传播到其子项目。 要监控所有项目的所有构建配置的构建,请选择 Root project

使用以下选项对选定的项目 / 构建配置中的通知进行细粒度控制:

  • 分支过滤器—— 选择此选项,只接收来自指定分支的构建的警报。 在 分支过滤器 中阅读更多。

  • 只有我的更改的构建 — 选择此选项以限制只通知包含您的更改的构建。

  • 只限我的最爱构建 — 将通知限制为您的 最爱构建

系统范围内的事件

选择接收分配给您的调查通知。

哪些事件将触发通知

构建失败

勾选此选项,您将收到有关指定项目和构建配置中所有已完成的失败构建的通知。 如果某个构建配置的调查已经分配给某人 在构建进行时,只有该用户才会收到构建失败的通知。

请注意,如果在 监视 区域选中了 只有我的更改的构建 ,那么如果包含您的更改的构建失败,TeamCity 将会通知您,并且在后续的每次“不完整”的构建中都会持续发送通知,直到构建成功。 不完整的构建是指已完成的构建在以下至少一种错误中失败:

  • 执行超时

  • JVM 崩溃了

  • JVM 内存溢出错误

  • 无法收集更改

  • 编译错误

  • 制品发布失败

  • 未知的失败原因

仅在成功后的首次构建失败时通知

选择此选项,只在成功构建后的首个失败构建,或者包含您更改的首个构建时接收通知。 当使用此选项时,您将不会收到后续构建失败的通知。

仅在出现新的构建问题或新的失败测试时通知

选择此选项,仅在构建出现新的构建问题或新的失败测试时才会收到通知。

构建成功

选择此选项,当指定的项目和构建配置成功执行构建时,您将收到通知。

仅在失败后的首次成功构建时通知

选择此选项,当失败的构建后首次成功构建时,您将收到通知。 关于后续成功构建的通知将不会被发送。

第一个错误发生了

勾选此选项,一旦检测到首个构建错误,即使构建尚未完成,也会立即收到关于 "构建失败" 的通知。

排队构建需要批准

选择此选项,以接收关于需要您批准的构建的通知。 这个选项会覆盖 只用我的更改构建 选项。

开始构建

选择此选项,以便在构建开始后立即接收通知。

构建无法启动

选择此选项,当构建 无法启动 时接收通知。

构建可能挂起了

选择此选项可在 TeamCity 将构建标识为 hanging 时接收通知。

调查已更新

选择此选项,以在更改构建配置或测试调查状态时接收通知,例如某人正在调查问题,或问题已被修复,或调查员已更改。

测试已被静音或取消静音

选择此选项,以在受影响的构建配置中接收关于测试 mute 状态更改的通知。

分配给我的调查

只有在 Watch 区域选中了 System wide events 选项后,此选项才可用。 检查选项以便每次您开始调查问题时获得通知。

规则处理顺序

TeamCity 按照它们呈现的顺序应用通知规则。 TeamCity 检查构建是否符合任何通知规则,并根据 第一个匹配的 规则发送通知;对相同构建的进一步匹配条件检查将不会执行。 您可以重新排序已配置的通知规则。

首先应用用户规则,然后应用群组规则。

群组规则是按照层级顺序处理的:从子群组开始到父群组。

如果有多个具有各自规则集的父级,那么继承的规则将按照在“通知规则”用户配置文件选项卡上(按字母顺序)呈现的顺序从上至下处理。

取消订阅及覆盖现有规则

您可能已经有一些由系统管理员为您所在的用户组配置的通知规则。

  • 要取消订阅或覆盖群组通知,请添加您自己的规则,规则中的被监视构建与原规则保持一致,但通知事件不同。

  • 要从所有事件中取消订阅,请添加一条规则,其中包含相应的被监视构建,且未选择任何事件。

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