运行自定义构建
构建配置通常使用 构建触发器 根据所需的时间表启动新的构建,或者当 TeamCity 检测到源代码中有新的更改时。
除了这些自动触发的构建外,TeamCity 还允许您手动运行构建,如果需要,还可以自定义它们的设置:添加新的或修改现有的属性,选择特定的更改,安排构建,选择哪个代理应该运行它,等等。
TeamCity 提供了多种运行自定义构建的选项:
单击 运行 按钮旁边的省略号按钮,并在 运行自定义构建 对话框中指定可选设置(有关更多信息,请参见 本节)。
要运行具有特定更改的自定义构建,请打开构建结果页面并切换到 更改 选项卡。 展开所需的更改,单击 使用此更改运行构建 按钮,并指定所需的 选项。
推广构建。
设置 构建触发器 以启动具有自定义参数的构建。
常规 选项卡显示最基本且最常用的设置。

此设置允许您选择应运行您的构建的代理。 以下选项可用:
<the fastest idle agent> (默认选项)— 如果选择此项,TeamCity 将自动选择一个代理来运行构建。
从列表中选择特定的 TeamCity 代理。 TeamCity 显示指定代理的当前状态,如果它已经在运行构建,会估计它何时会变为空闲。
<the fastest idle agent in the N pool> — TeamCity 将在指定池中的代理上运行构建。
如果已配置 云集成 ,您可以在从 特定云镜像 启动的代理上运行构建。 如果没有这种类型的云代理可用,TeamCity 将尝试启动一个新的。
<All enabled compatible agents> — 同时在所有已启用且与构建配置兼容的代理上运行构建。 使用此选项来:
为了进行代理维护,运行构建(例如,您可以创建配置以检查在环境升级/更新后代理是否正常运作)。
在不同的平台上运行构建(例如,您可以设置一个配置,并指定安装了不同环境的多个兼容构建代理。
保留 尽快 选项,以便在单击 运行构建 后立即将新构建放入常规队列。
要将构建安排到特定的日期&时间,请切换到 在特定日期和时间 选项。 计划构建会在 构建队列的最末端,直到到达它们预定的日期和时间。

作为个人构建运行 — 允许您运行 个人构建。
将构建置于队列顶部 — 将此新构建放置在当前 构建队列 的顶部。 由于您新启动的构建可能没有立即可用的兼容代理,因此在等待代理时,它可能会在队列中向下移动。 如果发生这种情况,请单击构建配置页面上的 移至顶部 图标,或导航到 构建结果页面 页面并单击 操作 | 移至顶部。
在构建之前删除检出目录中的所有文件 — 指定 TeamCity 是否应清除 构建签出目录。
如果配置了快照依赖,此选项可以应用于快照依赖。 在这种情况下,构建链中的所有构建都将使用干净的检出。
如果当前的构建配置使用的是 Perforce 版本控制系统根目录,您也可以在 搁置的文件 上运行自定义构建。 要做到这一点:
勾选 作为个人构建运行 选项。
输入包含暂存文件的变更列表的 ID。
选择目标 Perforce 根目录。
note
如果在 Perforce VCS 根中启用了流支持,即使指定了默认流,TeamCity 也会自动从更改的文件中检测目标流。
tip
学习如何使用 Perforce Shelve Trigger 自动运行搁置文件上的构建。
此选项卡仅适用于依赖于其他构建的构建。
依赖 选项卡允许您重建所有依赖项,并选择此新构建应使用其工件的特定构建。 默认情况下,TeamCity 显示最后的 20 个构建。 为了增加可用的最近构建次数,请添加 teamcity.runCustomBuild.buildsLimit=<您的值>
内部属性。
如果您重新运行一个依赖构建,TeamCity 将尝试重建所有依赖构建,包括之前失败的构建。
依赖项构建在列表中最初按照其按字母顺序排列的分支进行分组。 同一分支的构建按构建日期排序。 要放弃基于分支的排序并仅按日期对所有依赖构建进行排序,请单击 按日期排序依赖项。 这使您能够首先查看最近的构建。 要恢复默认排序,请单击 重置全部。
此选项卡仅在您的 TeamCity 用户具有访问构建配置的 VCS 根的权限时可用。
更改 选项卡允许您选择要包含到构建中的更改。 TeamCity 将使用更改的修订版来检出源, 并在这个新的构建中包含所有的更改,直到选择的那一个。
请注意,如果相应的 VCS 根被从构建配置中分离,TeamCity 将无法获取最新的提交,并且只显示有限数量的更改。 要使用较早的更改运行构建,请在更改日志中找到所需的提交并使用 使用此更改运行构建 操作。
包含更改 下拉菜单允许您选择应包含在此新构建中的附加到配置的 VCS 根中的更改。
在构建开始时的最新更改 :TeamCity 将自动包含当前可用的所有最新更改。
要包含的最后更改 :选择所需的更改以忽略所有后续提交。 TeamCity 将忽略最新更改的构建标记为 历史构建。
note
构建编号和构建历史列表反映了这些构建开始的时间。 因此,具有更大构建号码(并位于构建历史的顶部)的构建可能反映相比之前的更旧的源代码更改列表。
构建分支 下拉菜单在此构建配置(或其快照依赖配置)具有分支时可用。 允许您为自定义构建选择一个分支。
如果一个项目 在版本控制系统中存储其设置 ,此标签页允许您选择哪些设置应用于这个新的构建:
当前在 TeamCity 服务器上定义的设置
从为此构建计算的 VCS 修订版加载的设置。
默认行为取决于当前选择的 项目设置 | 版本化设置 页面设置(有关更多信息,请参见本节: 定义应用于构建的设置)。
如果您选择了 specific changes revision ,TeamCity 也会载入项目设置的相应版本。
note
这些设置仅在您的 TeamCity 用户具有更改此构建配置的系统属性和环境变量的权限时才可用。
此选项卡允许您添加、编辑和删除参数 / 属性 / 变量,并可覆盖 预定义参数 的初始值。
以下限制适用:
预定义的属性和变量不允许您编辑其名称(只能编辑值)。
您只能删除新添加的属性和变量。 预定义属性不能被删除。
参数值不能超过16,000个字符。
推广版本是自定义构建,其已重写了 artifact 或 snapshot 依赖。 此类构建使用的依赖构建与其默认使用的构建不同。
例如,构建配置 A 从构建配置 B 中检索工件。 通常,运行新的 A 构建会使用最后一次成功的 B 构建。 如果您希望 A 使用旧版的 B 构建,那么这个较早的 B 构建需要被提升。
要提升构建,请打开依赖构建的构建结果页面并单击 操作 | 提升。 促销只有一次性效果:在当前运行后,构建配置将恢复到其默认依赖逻辑(最后成功或最后固定的构建)。
请查看 以下博客文章 以获取更多信息。