构建缓存

最后修改日期： 2025年 3月 21日

构建缓存"功能允许构建配置发布在构建运行期间产生的特定文件（例如，下载的 npm 包或 Maven 本地仓库工件）。发布的缓存可以在同一配置发布的后续构建中被重用，或者其他配置也可以重用。这种技术优化并加速了构建程序。

常见信息

您可以设置 Build Cache 功能以在两种模式中的任意一种中运行。

初始构建缓存设置允许该功能下载在之前的构建中由相同功能发布的缓存。
或者，您可以设置一个 Build Cache 功能以发布缓存，然后从另一个 Build Cache（来自不同的构建配置）下载它。这种模式允许您设置“发布者”和“消费者”功能，以在不同的构建配置之间交换缓存。缓存 consumer 功能的数量没有限制，但它们应属于相同项目作为缓存 publisher。

缓存被发布为隐藏的工件，位于 .teamcity.build_cache 文件夹下。要查看已发布的缓存，请单击显示隐藏的工件链接，位于制品标签页。

由于缓存是作为工件发布的，因此它们会受到最大构建工件文件大小设置的影响，您可以在 Administration | Global Settings 页面上进行设置。

如果构建配置被设置为上传缓存，那么它会按照以下顺序排列其构建阶段：

这个部分将会演示如何设置 Build Cache 功能，该功能允许构建配置重用其自身之前构建的缓存。

将构建功能添加到构建配置中，并为 Cache Name指定一个唯一的名称。
由于我们希望该功能既发布又使用缓存，请保持发布和使用缓存设置均启用。
指定应被缓存的文件和文件夹的路径。每个路径应从新的一行开始。不支持通配符。相对路径是相对于检出目录解析的。
例如，要缓存由 npm install 或 yarn install 命令下载的 NodeJS 包，请在此字段中键入 node_modules/。
tip
为了缓存本地 Maven 工件，请将您的 Maven 运行器的 工件仓库 设置为 Maven 默认。如果您选择 Per agent 模式，请在功能的发布规则中使用默认的 .m2 位置。或者，将 -Dmaven.repo.local 参数添加到其他运行器命令中，并指向与 Build Cache 功能相同的目录。
默认情况下，如果新构建的缓存与之前构建发布的缓存相同，则不会发布缓存。如果您希望每个构建都上传缓存，取消选中 只有在改变时发布 设置。
保存设置。该功能在构建功能页面上的描述应说明它发布并使用相同的缓存。
运行构建并确保所有缓存文件都在构建结果页面上以 ".teamcity.build_cache" 隐藏工件的形式可用。
为确认在之前的运行中发布的缓存是否被使用，再次运行构建，并检查构建日志中的相应消息。

在此设置中，“发布者”Build Cache 功能添加到一个构建配置中，发布其缓存，而“消费者”Build Cache 功能添加到另一个配置中，下载这个缓存。下载的缓存被放置在与 publisher 的发布规则路径匹配的相同位置。

只要您为属于同一项目的配置添加了功能，您就可以根据需要设置尽可能多的发布者和消费者功能。

tip
一个 Build Cache 功能只能发布和使用一个缓存存档。如果您需要使用由多个构建配置发布的缓存，添加相应数量的 Build Cache 功能。

将构建功能添加到构建配置中，并为 Cache Name指定一个唯一的名称。
指定应被缓存的文件和文件夹的路径。每个路径应从新的一行开始。不支持通配符。相对路径是相对于检出目录解析的。
例如，要缓存由 npm install 或 yarn install 命令下载的 NodeJS 包，请在此字段中键入 node_modules/。
tip
为了缓存本地 Maven 工件，请将您的 Maven 运行器的 工件仓库 设置为 Maven 默认。如果您选择 Per agent 模式，请在功能的发布规则中使用默认的 .m2 位置。或者，将 -Dmaven.repo.local 参数添加到其他运行器命令中，并指向与 Build Cache 功能相同的目录。
默认情况下，如果新构建的缓存与之前构建发布的缓存相同，则不会发布缓存。如果您希望每个构建都上传缓存，取消选中 只有在改变时发布 设置。
取消选中使用缓存复选框。
保存设置。该功能在构建功能页面上的描述应说明它仅发布缓存。
运行构建并确保所有缓存文件都在构建结果页面上以 ".teamcity.build_cache" 隐藏工件的形式可用。