TeamCity On-Premises 2025.07 Help

构建审批

Build Approval 构建功能 允许用户通过使用审批手动控制构建的开始。 此构建功能确保构建在未获得审批规则中定义的个人用户或组的批准时不会启动。

此功能对于需要多个人批准的流程可能非常有用,例如部署、资源消耗型构建、资源移除操作等。 批准还可以防止用户意外触发构建。

如果构建在指定的时间内未获批准,它将会被取消。

构建审批设置

在您的构建配置中添加 Build Approval

此构建配置的所有构建都将需要审批。

选项

描述

批准规则

  • 基于用户的规则需要具体的 用户 的批准;每个用户都应该通过 用户:<用户名> 语法指定。 使用由新行分隔的用户列表。

  • 基于组的规则要求某个特定 的成员给予一定数量的批准;每个规则都应遵循 群组:<groupKey>:<approvalCount> 语法。 使用由新行分隔的组列表。

例如,以下规则只允许在获得 teamlead 用户、 projectadmin 用户以及至少两位 QA 组成员的批准后才开始构建:

user:teamlead user:projectadmin group:QA:2

您可以指定多个规则,需要多个用户和/或组的批准。 在这种情况下,必须满足规则的 全部 才能启动构建。

如果用户符合多个规则(例如,用户是规则中引用的多个组的成员),则该用户的批准将计入每个规则。 在上述示例中,如果 teamlead 用户是 QA 组的成员,那么当 projectadminteamlead 批准构建时,仅需 QA 组的一个额外批准即可启动构建。

您可以使用括号将单个用户和用户组分组为具有共享投票计数的单一投票权限。 对于多个组,请使用 群组 关键字,对于特定的 TeamCity 用户,请使用 users

(groups:QA_TEST,DEVELOPERS,users:john.doe,jane.doe):3

此规则要求组内任意组合总共获得三票。 例如:

  • jane.doejohn.doe 和任何 DEVELOPERS 成员;

  • 任意三个 QA_TEST 成员;

  • 两个 DEVELOPERS 成员和 john.doe

  • 至关重要

在中断

如果未得到批准,构建将在此时间段(以分钟计)后自动取消。 默认为 360 分钟(6 小时)。

将手动启动的构建视为批准

如果启用了此选项,且构建触发者拥有审批构建的权限,该功能将自动在此构建中添加此用户的批准。 如果未启用此选项,构建仍需要获得规则中指定的人员的明确批准,无论是谁触发的构建。

通知 & 审计

所有审批者都会收到电子邮件通知:这是包含在默认的 通知规则中的 所有用户组。 请考虑添加相关的 Slack 通知。 与构建审批相关的通知将覆盖通知规则中的 仅与我的更改相关的构建 选项。

您还可以使用启用了 构建需要批准 选项的 Notifications 构建功能, 为您的构建配置添加通知

当用户批准一次构建时,将创建一个相应的 审计条目

最后修改日期: 2025年 8月 12日