创建和编辑构建配置

要找到构建配置创建向导：

1. 转到 管理 | 项目 并打开所需的项目。
   或者，使用 项目 弹出菜单打开项目，然后单击 编辑项目设置。
   项目设置 页面将打开。

2. 在 项目设置s 页面上，单击 创建构建配置 ，位于 构建配置 部分下方。

3. 请根据您选择的方法遵循特定的说明：

   • 手动

   • 指向一个仓库 URL

   • 指向 GitHub.com ，GitLab CE/EE ，Bitbucket Cloud ，Azure DevOps Services 和 JetBrains Space 中的仓库

   • 基于 构建配置模板

在创建构建配置后，您可以：

• 更改它们的顺序

• 编辑其设置

• 通过 Actions 菜单来控制它们

在 构建配置创建向导 中：

1. 单击 来自存储库 URL。

2. 输入您的 VCS 仓库 URL ，如果需要身份验证，请输入 VCS 凭证（用户名和密码 / 令牌）。

3. 单击 创建。

TeamCity 会建议构建配置名称，并为您配置其余的设置：

• 它将确定 VCS 仓库的类型，并创建一个 VCS root。 对于 Git 仓库，它将自动检测默认分支。 您现在或稍后有选项在 VCS root 设置中进行更改。 您也可以改变分支规格：默认情况下，TeamCity 会监视存储库的所有分支，但您可以通过输入 自定义规则 来选择需要监视的确切分支。

• 它将尝试自动检测构建步骤：Ant 、NAnt 、Gradle 、Maven 、MSBuild 、Visual Studio 解决方案文件、PowerShell 、Xcode 项目文件、Rake ，以及 IntelliJ IDEA 项目。 您可以随时添加和编辑它们 手动。

接下来，TeamCity 将显示建议图标，并提示创建 构建触发器、 失败条件 和 构建功能。 根据构建配置设置，它可能会建议一些额外的配置选项。

在构建配置创建后，您可以运行构建和/或调整设置。

在 构建配置创建向导 中：

1. 点击与您的 VCS 相对应的按钮：来自 GitHub.com、GitLab CE / EE、Bitbucket Cloud、Azure DevOps Services 或 JetBrains Space。
   请注意，为了能够访问选定的 VCS，TeamCity 需要始终具有其可供使用的连接参数。 您可以提前配置连接预设并在向导中选择目标 VCS 服务器，或者让 TeamCity 直接从向导将您重定向到 连接 页面。 受支持的 VCS 提供商的连接设置在 这里 描述。

2. 验证与 VCS 的连接。

3. TeamCity 将提出建立配置名称。 如有需要，您可以更改它。
   对于 Git 仓库，它还会自动检测默认分支。 您现在或稍后有选项在 VCS root 设置中进行更改。 您还可以更改分支规范：默认情况下，TeamCity 监控存储库的所有分支，但您可以通过输入 自定义规则来选择要监控的具体分支。
   单击 继续。

4. TeamCity 将添加一个 VCS 构建触发器，并尝试 自动检测构建步骤 ：Ant、NAnt、Gradle、Maven、MSBuild、Visual Studio 解决方案文件、PowerShell、Xcode 项目文件、Rake 以及 IntelliJ IDEA 项目。 在 自动检测的构建步骤 页面上，选择要在构建配置中使用的步骤。 单击 使用已选择的。 您可以随时添加或编辑步骤 手动。
   根据构建配置设置，TeamCity 可以提供一些额外的配置选项。 审查建议的设置 并配置所需的设置。

构建配置已创建。 单击 运行 以启动其第一次构建。

在构建配置创建向导中：

1. 单击 手动

2. 在 创建构建配置对话框中，指定构建配置的名称、ID 和（可选的）描述，然后单击 创建。

3. 继续创建其他设置：

   • 创建/编辑 VCS 根并指定 VCS 特定设置

   • 在 构建步骤 页面上，配置由自动检测发现的构建步骤。 要手动创建它们，您可以从下拉菜单中选择所需的构建运行程序。 单击 保存。 您可以在一个构建配置中添加尽可能多的构建步骤。 请注意，它们将会按顺序执行。 最后，构建会获得合并状态，输出则会进入同一构建日志。 如果某个步骤失败，其余步骤是否执行，取决于他们的 步骤执行策略。

   • 另外，配置 构建触发选项、 依赖项、 属性和变量 ，以及 代理要求。

创建新的 构建配置模板 的过程与创建新配置类似：

1. 在 管理 | 项目 页面上，从列表中选择目标项目。
   或者，使用 项目 弹出菜单打开项目，然后单击 编辑项目设置。
   项目设置 页面打开。

2. 在 项目设置 页面上，单击 创建模板 ，位于 构建配置模板 部分下方。

3. 继续配置 一般设置、 VCS 设置 ，以及 构建步骤。

或者，您可以从现有的构建配置中创建一个构建配置模板：

1. 打开现有的构建配置设置页面，单击屏幕右上角的 操作 ，然后选择 提取模板 选项。

2. 指定所需的设置并单击 创建。

tip

当您从零开始创建一个模板，或者从现有的构建配置中提取它时，这个模板只适用于此项目（及其子项目）。 这意味着您无法在 "< Root project >/ProjectA" 中使用 "< Root project >/ProjectB/BuildConfTemplate" 模板创建新的配置。

您可以通过两种方式创建模板化的构建配置：从模板设置页面，或通过创建常规配置并选择应使用的模板。

选项 #1：

1. 导航到 管理 | 项目 并选择拥有模板的项目。

2. 单击 构建配置模板 部分下所需的模板。

   

3. 单击 操作 | 从此模板创建构建配置...。

   

4. 指定新配置所需的设置。 不要单击 手动 以外的任何磁贴；否则，您将创建一个未使用所选模板的新配置。

选项 #2：

1. 导航到 管理 | 项目 并选择拥有模板的项目。

2. 单击 创建构建配置 ，位于 构建配置 部分下方。

   

3. 单击 手动 磁贴，并在 基于模板 下拉菜单中选择所需的模板。

   

选项 #2 在 构建配置模板 部分未显示所需模板（因为它由另一个（子）项目拥有）时很有帮助。

note

在从此模板创建的配置中，无法编辑模板中指定的设置。 然而，其中一些可以在 构建配置中被重新定义。 请注意，修改模板本身的设置将影响基于此模板的 所有配置。

您可以在 项目概览 页面上查看项目的所有构建配置。 默认情况下，它们是按字母顺序列出的，但管理员可以 自定义这个顺序。

构建配置设置包括：

• 一般设置

• 版本控制设置 ，定义了如何从 VCS 中检索源代码，检出到何处等等

• 构建步骤 ，即按顺序运行的动作：例如，运行 msbuild，一个脚本，或单位测试

• 触发器 ，这些是定义何时启动新构建的规则

• 失败条件 规定了何时会将构建标记为失败

• 附加的 构建功能

• 依赖项:

  • 对于 快照依赖 ，TeamCity 会在它们所依赖的构建开始时运行所有依赖的构建，这些源是在构建开始时获取的。

  • 对于 工件依赖 ，在构建开始之前，所有这个构建依赖的工件都将被下载并放置在它们配置的目标位置，然后将由构建使用。

• 参数允许共享设置

• 代理要求指定某个 构建配置是否可以在特定的 构建代理上运行。

note

构建配置设置和构建行为可能会根据构建配置的类型而变化。

虽然只有具有 项目管理员权限的用户才能更改项目和构建配置设置，但是对源代码做出贡献的参与者也有许多方式可以影响构建设置和环境。

默认的 Project Developer 角色 授予用户两项权限：

• 自定义构建参数允许更改 构建配置参数的值，从而可能影响源代码的执行方式。

• 使用自定义补丁更改构建源代码允许根据用户的本地源文件运行 自定义构建 ，而这些文件尚未提交至存储库。

此外，所有编写源代码或/和可以在其中存储项目设置的 Kotlin DSL 仓库中写入的用户，都可能在共享构建代理上执行他们的任意代码。

我们建议在授予用户上述权限或向项目仓库写入访问权限时，考虑这个方面。 如果需要，您可以调整分配给每个 权限的集合。

使用位于设置屏幕右上角的 操作 菜单以：

• 暂停/激活构建配置。

• 复制/移动/删除构建配置。

• 将构建配置附加到模板。

• 从构建配置中提取模板。

• 从构建配置中提取配方。

• 将历史记录附加到构建配置。