构建缓存

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

• 初始构建缓存设置允许该功能下载在之前的构建中由相同功能发布的缓存。

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

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

由于缓存被发布为工件，因此受到您可以在 Administration | Global Settings 页面设定的 最大构建工件文件大小 设置的影响。

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

1. 解决工件依赖性问题

2. 下载缓存

3. 检出源代码

4. 启动构建

1. 将构建功能添加到构建配置中，并为Cache Name指定一个唯一的名称。

2. 指定应被缓存的文件和文件夹的路径。 每个路径应从新的一行开始。 不支持通配符。 相对路径是相对于检出目录进行解析的。
   

   例如，要缓存由 npm install 或 yarn install 命令下载的 NodeJS 包，请在此字段中键入 node_modules/。

   tip

   为了缓存本地 Maven 工件，请将您的 Maven 运行器的 工件仓库 设置为 Maven 默认。 如果您选择 Per agent 模式，请在功能的发布规则中使用默认的 .m2 位置。 或者，将 -Dmaven.repo.local 参数添加到其他运行器命令中，并指向与 Build Cache 功能相同的目录。

3. 默认情况下，如果新构建的缓存与之前构建发布的缓存相同，则不会发布缓存。 如果您希望每个构建都上传缓存，取消选中 只有在改变时发布 设置。

4. 取消勾选 Use Cache 复选框。

5. 保存设置。 在 构建功能 页面上的特性描述应说明它只发布缓存。

   

6. 运行构建并确保所有缓存文件都在构建结果页面上以 ".teamcity.build_cache" 隐藏工件的形式可用。

1. 将构建功能添加到构建配置中，并指定与发布者特性使用相同的Cache Name。

2. 取消勾选 Publish 复选框。

3. 保存设置。 在 Build Features 页面上，该功能的描述应当说明它仅使用缓存。

   

4. 运行一个新的构建，并检查构建日志以确保需要的缓存文件已经下载。

5. 对于需要此发布缓存的每一个构建配置，请重复以上步骤。