添加构建功能

一种 构建功能 是可以添加到构建配置中的一个功能片段，用以影响正在运行的构建或报告构建结果。

TeamCity 构建功能

TeamCity 包含以下可添加到您的配置中的构建功能：

AssemblyInfo Patcher: 允许您自动设置程序集的构建号，无需手动修补 AssemblyInfo.cs 文件。了解更多...
自动合并: 跟踪所需分支中的构建，并且如果构建满足配置的条件（例如，构建成功），则将其合并到目标分支。了解更多...
AWS 凭证: 将 TeamCity 项目中配置的 AWS 连接共享给构建步骤。了解更多...
构建审批: 允许您指定需要批准开始新建的 TeamCity 用户。了解更多...
构建文件清理器（Swabra）: 清理构建过程中产生的文件。了解更多...
构建缓存: 允许构建获取之前完成的构建所获取的文件（例如，下载的 npm 包。了解更多...
提交状态发布器: 将构建阶段和最终结果报告给外部系统。了解更多...
Docker 支持: 允许构建配置在构建开始前自动登录 DockerHub 或其他容器注册表。了解更多...
文件内容替换器: 在构建开始之前，使用正则表达式替换文本文件的内容，并在构建结束后回滚所有更改。了解更多...
Free Disc Space: 在运行构建前检查构建代理是否有足够的空闲磁盘空间，如果没有，则清理旧的构建数据。了解更多...
Golang: 在 TeamCity 中启用 Go 测试结果的实时报告和历史记录。了解更多...
调查自动分配器: 分析构建问题和测试失败，并确定可能导致这些问题的用户的提交。了解更多...
Jira Cloud 集成: 允许直接实时向 Jira Cloud 报告构建状态。了解更多...
矩阵构建: 允许您设置一个矩阵，其中多个参数各自有多个可能的值。运行此类构建配置会产生 N 个分别测试每个单独参数/值组合的独立构建。了解更多...
通知: 通过电子邮件或 Slack 消息通知所需用户有关构建状态和事件的信息。了解更多……
NuGet 订阅源凭证: 允许构建与需要身份验证的 NuGet 饲料进行交互。了解更多...
NuGet 包索引器: 对 NuGet 包进行索引，并将它们添加到 TeamCity 远程私有源中，无需额外授权。了解更多...
性能监视器: 允许您在构建代理上运行构建时获取 CPU 、磁盘 I/O 和内存使用的统计信息。了解更多...
Pull Request: 允许您构建尚未合并到目标仓库分支的更改。了解更多...
Ruby 环境配置器: 它将所选的 Ruby 解释器和 gems bin 目录添加到系统 PATH 环境变量，并且在 RVM 解释器的情况下配置其他必要的环境变量。了解更多...
并行测试: 将大量测试分解为更小的批次，并使用多个 TeamCity 代理来运行每一批。了解更多…
共享资源: 允许通过使用共享的外部（对于 CI 服务器）资源（例如，测试数据库或连接数量有限的服务器）来限制同时运行的构建。了解更多...
SSH 代理: 在构建过程中，使用已上传的选定SSH密钥运行SSH代理。了解更多...
版本控制系统标签: 启用在您的版本控制系统中自动和手动标签（标记）构建源。了解更多...
XML 报告处理: 解析外部工具生成的 XML 报告，并在构建页面上显示结果。了解更多...

如何添加、移除和禁用构建功能

在 TeamCity 用户界面

导航至 Administration | <YOUR_PROJECT> | <YOUR_BUILD_CONFIGURATION> ，然后切换到 构建功能 选项卡。
点击 Add build feature 并从列表中选择所需的功能。
指定所需的功能设置并点击 Save。

Build Features 页面还允许您暂时禁用或永久删除已配置的构建功能。

在 Kotlin DSL 中

将相应的功能添加到您的 Kotlin DSL 的 Approval 块中。例如，以下样本添加了构建审批功能，该功能要求一个用户批准新的配置构建。

object MyBuildConfig : BuildType({
    // ...
   features {
       approval {
           approvalRules = "user:Valravn"
       }
   }
})

另请参见：构建功能 | Kotlin DSL 文档。

使用 REST API

向 /app/rest/buildTypes/<build_type_locator>/features 端点发送 GET 、 POST 和 DELETE 请求，以获取和删除现有的构建功能，并添加新的功能。

例如，使用以下正文的 POST 请求将 Pull Request 功能添加到配置中。

{
    "type": "pullRequests",
    "properties": {
        "property": [
            { 
                "name": "providerType",
                "value": "github"
            },
                        { 
                "name": "ignoreDrafts",
                "value": "true"
            }
        ]
    }
}

<feature type="pullRequests">
    <properties count="2">
        <property name="ignoreDrafts" value="true"/>
        <property name="providerType" value="github"/>
    </properties>
</feature>

要禁用现有的功能，向 /app/rest/buildTypes/<构建类型定位器>/features/<ID>/disabled 发送一个带有 true 文本体的 PUT 请求。

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