非活跃项目删除

  • 引入于 15.0 版本,功能标志inactive_projects_deletion。默认禁用。
  • 功能标志 inactive_projects_deletion 删除于 15.4 版本。

大型极狐GitLab 实例的管理员会发现,随着时间的推移,项目会变得不活跃并且不再使用。 这些项目占用了不必要的磁盘空间。通过非活跃项目删除,您可以识别这些项目,提前警告维护人员,然后在项目仍然处于非活跃状态时将其删除。删除非活跃项目时,该操作会生成由 @GitLab-Admin-Bot 执行的审计事件。

配置非活跃项目删除

您可以配置非活跃项目删除或使用以下任一方法将其关闭:

可以使用以下选项:

  • 删除非活跃项目delete_inactive_projects):启用或禁用非活跃项目删除。
  • 删除超过一定大小inactive_projects_min_size_mb) 的非活跃项目:考虑删除的非活跃项目的最小大小 (MB)。小于此阈值的项目不会被视为非活跃项目。
  • 删除项目前的非活跃时长inactive_projects_delete_after_months):如果项目继续处于非活跃状态,则计划删除的最短持续时间(月)。
  • 发送警告邮件inactive_projects_send_warning_email_after_months):如果项目继续处于非活跃状态,则在此之后发送删除警告电子邮件的最短持续时间(月)。警告电子邮件将发送给具有非活跃项目的所有者和维护者角色的用户。此时长必须小于 删除项目前的非活跃时长inactive_projects_delete_after_months)。

例如(使用 API):

  • delete_inactive_projects 已启用。
  • inactive_projects_min_size_mb 设置为 50
  • inactive_projects_delete_after_months 设置为 12
  • inactive_projects_send_warning_email_after_months 设置为 6

在这种情况下,当项目的大小:

  • 小于 50 MB,该项目不被认为是非活跃的。
  • 大于 50 MB 并且在以下情况下处于非活跃状态:
    • 超过 6 个月,以电子邮件形式,给在项目中具有所有者和维护者角色的用户发送删除警告,并且包含计划删除日期。
    • 超过 12 个月,项目按计划进行删除。

使用 API

您可以使用应用程序设置 API 来配置非活动项目。

使用 UI

引入于 15.1 版本。

使用 UI 配置非活跃项目:

  1. 在顶部栏上,选择 主菜单 > 管理员
  2. 在左侧边栏上,选择 设置 > 仓库
  3. 展开 仓库维护
  4. 非活跃项目删除 部分,配置必要的选项。
  5. 选择 保存更改

确定项目上次活动的时间

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

  1. 前往项目的动态页面,查看最新活动日期。
  2. 使用项目 API,查看项目的 last_activity_at 属性。
  3. 使用事件 API,列出项目的可见事件。查看最新事件的 created_at 属性。