如何阻止TeamCity每次重新构建Docker依赖项？

听起来你遇到的是TeamCity快照依赖复用逻辑未按预期生效的问题——明明配置了“如果存在合适构建则不运行新构建”，但每次触发docker-compose构建时，十几个容器项目还是会重复执行构建。我来分享几个排查和解决的具体方向：

1. 先确认快照依赖的配置细节 #

逐个检查每个容器构建任务的快照依赖设置：

• 进入你的docker-compose构建项目的快照依赖配置页，点击每个容器任务的编辑按钮
• 确保“运行选项”里的**“如果存在合适的构建，则不运行新构建”**处于勾选状态，同时要注意：这里的“合适构建”默认指「与当前docker-compose构建具有相同VCS快照的最近成功构建」。由于你的容器项目和docker-compose项目使用独立VCS根，TeamCity需要明确匹配到对应容器仓库的当前版本无变更，才会复用旧构建。

2. 验证VCS版本的关联匹配 #

每个容器代码都在独立的BitBucket仓库，VCS根分离很容易出现版本不匹配问题：

• 当docker-compose项目触发构建时，TeamCity会生成包含所有关联VCS根版本的快照。如果某个容器仓库代码无变更，TeamCity应找到该容器项目中对应此VCS版本的最近成功构建并复用。
• 你可以在docker-compose构建日志里搜索类似「Reusing build XXX for dependency XXX」的条目，如果看不到这类日志，说明TeamCity认为没有匹配的构建，此时要检查容器项目的VCS根配置是否正确，以及是否存在对应版本的成功构建。

3. 确保容器构建的稳定性 #

如果某个容器项目的最近构建处于失败状态，TeamCity会忽略它并尝试重新构建，即使VCS无变更：

• 查看每个容器项目的构建历史，确认最近的构建均为成功状态。如果有失败构建，先修复问题，让TeamCity有可复用的“合适构建”。
• 同时检查容器项目的构建配置，确保开启了「仅当VCS变更时构建」，避免无意义的自动重建。

4. 调整“合适构建”的判断条件 #

如果默认判断逻辑不符合你的场景，可以自定义快照依赖的复用规则：

• 在快照依赖的编辑页面，点击「高级选项」，找到「合适构建的条件」，可选择更精确的规则，比如「使用具有相同VCS版本的构建」或者「使用最近成功且标记为稳定的构建」。
• 如果所有容器都在固定分支（比如主分支）构建，可勾选「忽略分支」，让TeamCity更宽松地匹配可复用的构建。

5. 排查触发器的冲突问题 #

你提到每个容器都配置了对应文件的触发器，要确保这些触发器不会干扰docker-compose的快照依赖逻辑：

• 检查docker-compose项目的触发器：是否仅在docker-compose.yml模板或相关配置变更时触发？如果是定时触发或全局触发器，可能会频繁触发docker-compose构建，此时若容器仓库有微小无关变更（比如README修改），也会触发容器重建——可以给容器项目的触发器添加路径过滤，只监听Dockerfile和业务代码的变更，忽略无关文件。
• 另外，不要给容器项目设置「触发快照依赖构建」的选项，否则容器构建会反向触发docker-compose构建，形成循环。

6. 利用构建参数传递验证复用逻辑 #

你需要获取每个容器的build_counter，可以通过参数传递确认是否真的复用了旧构建：

• 在docker-compose项目的构建参数里，添加依赖构建的参数引用，比如%dep.ContainerProjectName.build.counter%（替换为你的容器项目名称）。如果复用了旧构建，这个参数会直接使用旧构建的计数器；如果重新构建，计数器会更新——通过查看构建参数的值，能快速判断复用逻辑是否生效。

内容的提问来源于stack exchange，提问作者Isaac Freeman