Commit 526da962 authored by James Ramsay's avatar James Ramsay

Rewrite repo size reduction docs

Purging data from a Git repo can be useful for different reasons,
including making cloning faster, or reducing repo size on the GitLab
server. The first is easy, the second is hard.

Documentation has been rewritten to use `git filter-repo` which is the
leading repo rewriting tool for this application, and is recommended by
the Git project.

Documentation now also provides workflow for pruning all kinds of refs,
including refs/keep-around/* which was not documented. This meant
purging files was incomplete from disk use perspective on the GitLab
server.

References to BFG have been removed.
parent cdcdeccc
...@@ -97,7 +97,7 @@ Read the documentation on how to [migrate an existing Git repo with Git LFS](mig ...@@ -97,7 +97,7 @@ Read the documentation on how to [migrate an existing Git repo with Git LFS](mig
To remove objects from LFS: To remove objects from LFS:
1. Use [BFG-Cleaner](../../../user/project/repository/reducing_the_repo_size_using_git.md#using-the-bfg-repo-cleaner) or [filter-branch](../../../user/project/repository/reducing_the_repo_size_using_git.md#using-git-filter-branch) to remove the objects from the repository. 1. Use [`git filter-repo`](../../../user/project/repository/reducing_the_repo_size_using_git.md) to remove the objects from the repository.
1. Delete the relevant LFS lines for the objects you have removed from your `.gitattributes` file and commit those changes. 1. Delete the relevant LFS lines for the objects you have removed from your `.gitattributes` file and commit those changes.
## File Locking ## File Locking
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment