快照依赖

依赖于

指定依赖的构建配置。

在我们的示例中，选择构建 A 作为当前构建 B 的依赖项。

执行修订版本同步

对于链中的所有构建，如果通过此选项 已启用 （默认情况下）由快照依赖项链接，TeamCity 将使用相同来源的快照（例如，相同 VCS 根的相同修订版）。 这是一个推荐的设置，用于需要使用源文件相同状态来成功构建的配置。

如果您为快照依赖项 禁用 此选项，那么当 依赖项构建 被提升到当前构建配置时，当前构建配置的构建将使用来源的最新修订版，而不是与提升的依赖项对应的修订版。 当构建没有严格的源依赖性时（例如，与包和部署步骤一样），这是有用的。

在我们的例子中，如果构建 B 的快照依赖性禁用了此选项，那么行为如下：构建 A 在修订 1.2 上启动，完成后，升级为构建 B。 在启动 B 的时候，TeamCity 将找到构建 B 的最新修订版本（比如说 1.3）。
否则，如果启用了此选项，TeamCity 将在与 A 相同的 1.2 修订版本上启动构建 B。

请注意，源的快照规则仅应用于通过启用选项的快照依赖关联的 构建链的部分。

如果有合适的构建，则不要运行新构建

如果启用此选项，那么如果已经存在具有适当源修订版本的正在运行或已完成的依赖构建，TeamCity 将不会运行新的依赖构建。 另请参见 适用的构建。
在这种情况下，当触发依赖构建时，依赖性构建也将加入队列。 然后，当收集到构建链的更改时，此依赖项构建将从队列中删除，并将依赖项设置为合适的已完成构建。

note

如果某个构建配置有多个快照依赖，那么如果您想确保所有的构建重用都能正常运作，那么所有的快照依赖都必须启用 "如果有适合的构建，不要运行新的构建" 选项。

只使用合适的成功构建

新触发的构建只会使用成功完成的 合适构建 作为依赖。 如果最新完成的合适构建失败，它将被重新运行。

在同一代理上运行构建

当启用此功能并且 B 快照依赖于 A 时，每个 B 构建都会在运行相同构建链的 A 构建的相同代理上运行。

note

在开始具有 在同一代理上运行 依赖项的构建链之前，TeamCity 将通过这种依赖项将构建组合成组。 对于参与此类组的每个开始构建，TeamCity 选择可以被组中任何构建使用的代理。 因此，这个选项对于 composite builds 也是有意义的，尽管合成构建不会占用代理，但它仍然可以形成由这种依赖性组合的构建组。 例如，组合构建 B 具有对 A 和 C 的 在同一代理上运行 的依赖性，将导致 A 和 C 使用相同的代理。

在依赖失败时/在启动失败或取消依赖时

如果依赖关系失败，您可以通过选择以下选项之一来管理依赖构建的状态：

• 运行构建，但添加问题 ：将运行依赖构建，并将问题添加到其中，状态更改为失败（如果问题之前未被静音）。

• 运行构建，但不添加问题 ：将运行依赖构建，但不会添加问题。

• 将构建标记为启动失败 ：依赖构建将不会运行，并将被标记为“ 启动失败”。

• 取消构建 ：依赖构建将不会运行，并将被标记为“ 已取消”。