休眠项目删除

随着时间的推移，大型 GitLab 实例中的项目可能会变得不活跃（休眠），从而占用不必要的磁盘空间。

您可以配置 GitLab，使其在项目不活跃特定一段时间后，自动删除这些休眠项目。 当项目在规定期限内没有任何活动时：

• 维护者会收到关于计划删除的警告通知。
• 如果项目在此期间仍然没有活动，GitLab 会在时间期限到期后将其删除。
• 当删除操作发生时，GitLab 会生成一条审计事件，显示由 @GitLab-Admin-Bot 执行了此次删除。

有关 GitLab.com 上的默认设置，请参阅 GitLab.com 设置。

配置休眠项目删除

要配置休眠项目的删除：

1. 在左侧边栏的底部，选择 管理员。
2. 选择 设置 > 仓库。
3. 展开 仓库维护。
4. 在 休眠项目删除 部分，选中 删除休眠项目。
5. 配置相关设置。
   • 警告邮件将发送给拥有该休眠项目所有者（Owner）和维护者（Maintainer）角色的用户。
   • 发送邮件的时长必须小于 删除项目前 的时长。
6. 选择 保存更改。

符合条件的休眠项目将被计划删除，并发送警告邮件。如果这些项目继续保持休眠状态，它们将在指定的时长后被删除。即使项目已被归档，这些项目也会被删除。

配置示例

示例 1

如果您使用以下设置：

• 删除休眠项目 已启用。
• 删除超过以下大小的休眠项目 设置为 50。
• 删除项目前 设置为 12。
• 发送警告邮件 设置为 6。

如果项目小于 50 MB，则该项目不被视为休眠项目。

如果项目大于 50 MB 并且已休眠：

• 超过 6 个月：将发送删除警告邮件。该邮件包含项目将被计划删除的日期。
• 超过 12 个月：该项目将被计划删除。

示例 2

如果您使用以下设置：

• 删除休眠项目 已启用。
• 删除超过以下大小的休眠项目 设置为 0。
• 删除项目前 设置为 12。
• 发送警告邮件 设置为 11。

由于大小限制已设置为 0 MB，因此实例中的所有项目都将被覆盖。 如果项目已休眠：

• 超过 11 个月：将发送删除警告邮件。该邮件包含项目将被计划删除的日期。
• 超过 12 个月：该项目将被计划删除。

如果您在配置这些设置时，存在一个已经休眠超过 12 个月的项目：

• 将立即发送删除警告邮件。该邮件包含项目将被计划删除的日期。
• 该项目将在警告邮件发送后 1 个月（12 个月 - 11 个月）被计划删除。

确定项目上次活跃的时间

您可以通过以下方式查看项目的活动并确定项目上次活跃的时间：

• 前往项目的活动页面，查看最新事件的日期。
• 使用 Projects API 查看项目的 last_activity_at 属性。
• 使用 Events API 列出项目的可见事件。查看最新事件的 created_at 属性。