TeamCity 数据清理

手动清理启动

服务器清理设置的 上一次清理 部分使您能够：

• 查看上一次服务器清理日期和持续时间的信息，帮助您决定是否在特定时刻启动清理进程。

• 手动运行清理，使用立即开始清理按钮。

在清理过程中，TeamCity 报告了进度。 如果需要，您可以停止清理过程，剩余的数据将在下次清理时被移除。

基础规则

每个项目或构建配置都被分配了一条基本规则。 有了基本规则，您可以定义要保留的成功构建的数量，和/或保留构建历史的时间周期。

以下清理级别在基本规则中可用：

• Artifacts：包括构建日志在内的所有数据都将被保存；隐藏的工件 也将被保存。

• 历史记录：除了在 统计图表中可见的构建统计值外，所有构建数据都被删除。

• 所有内容：TeamCity 中不再保留任何构建数据。

每个级别都包含了其上面所列出的内容。

默认情况下，所有内容都将永久保留。 当您选择自定义设置时，您可以为上述每个级别指定：

• 天数：
  早于指定天数的构建将以指定的级别进行清理。 起始点是最后一次成功构建的日期，而不是当前日期。 一天等于24小时周期，而非日历中的一天。

• 成功构建的数量：
  只有在上次匹配成功的构建之后的构建才会用指定的级别进行清理（保存成功的构建之间的所有失败的构建都会被保留）。

当指定了两个条件时，只有根据所有适用的规则必须清理并且没有被保留规则保留的构建才会被实际删除：TeamCity会找到根据每条规则应该保留的最旧的构建，然后清理所有比这两个找到的最旧的构建还要旧的。
请注意，如果为层级指定了 成功构建的数量 限制，但历史记录中没有成功的构建，TeamCity将不会清理该层级上的任何数据。

对于 Artifacts 级别，您还可以指定工件名称的模式：匹配指定模式的工件将被包含或排除在清理之外。 遵循 Ant-like pattern 的换行分隔规则。 例如：

• 为了清理名称中包含 文件 部分的工件，请使用以下语法： +：**/file*.*。

• 若要从清理中排除名称中包含 文件 的 *.jar 工件，请使用 -:**/file*.jar。

保持规则

保留规则定义了在清理过程中需要保留的特定数据。 多个保留规则可以分配给一个项目或构建配置。

在每条保持规则中，您可以配置以下设置：

• 构建用于保存的数据：历史记录，工件，日志，统计数据，或所有内容。

• 是否要在依赖关系中 保留工件。 这个选项控制是否同时清理依赖构建配置的构建。 启用此选项后，如果某个构建被此规则保留，那么它的依赖构建的所有工件也将被保留。 此选项的工作方式与基础规则的 Dependencies 选项类似。

• 构建范围：规则将影响哪个时间间隔或最后构建的数量。

• 如有需要，您可以按照保留构建的 状态、 标签 和 分支（支持具有模式匹配的 分支过滤器）进行 过滤。 您也可以仅对个人或非个人构建应用规则。

• 选择是否需要将限制单独应用于每个匹配的分支，或者将其作为一个整体应用于所选分支中的所有构建。
  此条件每个受影响的构建配置应用一次。 如果过滤器中未指定任何分支，则其应用如下：应用于构建配置中的每个分支，或者作为一组应用于所有构建配置分支。
  例如：如果您选择保留最后10次构建的统计信息，并为此规则选择两个分支，则您可以选择"全部所选"以保留两个所选分支中的最后10次构建，或者选择"各选定的分支"以保留最后20次构建——每个分支10次。

TeamCity 按照以下顺序处理保持规则：

1. 过滤器用于筛选受影响的项目或构建配置的构建。

2. 确定规则是否适用于所有选定的分支，或者是针对每个选定分支中的构建（请参见 描述）。

3. 仅在指定的 范围 内保留构建。

4. 确定要保留哪些类型的 build data。

5. 确定是否必须保留依赖构建的工件。

关于 keep 规则行为的说明：

• 如果输入了多个标签，该规则将适用于所有标记有这些标签中的任何一个的构建。

• 在所有 "Days since" 范围选项中，TeamCity 不会考虑某个日期的小数小时，并且仅对在选定日期（从午夜到晚上 11:59）及其之后到受影响范围开始日（选定日期减去配置的天数限制）的时间间隔开始的构建应用规则。