Skip to content

Docs: Keep-around orphaned references rake task not providing enough guidance

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

Problem to solve

We provide the a rake task to check if there are Keep-around orphaned references.

But as seen on some tickets (at least this one: internal link) the documentation doesn't tell:

  • Is there any expected number here? Is having 5, 1000 or 2M acceptable?
  • What shall be done with the output?
  • What's the impact of having too many?
  • I suspect we need to run Reduce repository size with the list from the rake task, but having confirmation would be helpful.

Further details

Proposal

I think having more context about when to run this command, what do to with the output and how to fix this would be helpful to our customers.

Who can address the issue

The MR for the doc and rake task is !191591 (merged) so I'm tagging @proglottis and @samihiltunen due to https://gitlab.com/gitlab-com/request-for-help/-/issues/2919

Edited by olivier némoz saint-dizier