git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: worktrees vs. alternates

From
Konstantin Ryabitsev <konstantin@linuxfoundation.org>
Date
May 16, 2018, 14:58 UTC
Message-ID
<0f19f9f8-d215-622e-5090-1341c013babc@linuxfoundation.org>
In-Reply-To
<fc2f1fdf-222f-aaee-9d58-aae8692920f5@gmail.com>
On 05/16/18 09:02, Derrick Stolee wrote:
Show 7 quoted lines
> This is the biggest difference. You cannot have the same ref checked out
> in multiple worktrees, as they both may edit that ref. The alternates
> allow you to share data in a "read only" fashion. If you have one repo
> that is the "base" repo that manages that objects dir, then that is
> probably a good way to reduce the duplication. I'm not familiar with
> what happens when a "child" repo does 'git gc' or 'git repack', will it
> delete the local objects that is sees exist in the alternate?

The parent repo is not keeping track of any other repositories that may be using it for alternates, which is why you basically:

1. never run auto-gc in the parent repo
2. repack it manually using -Ad to keep loose objects that other repos
may be borrowing (but we don't know if they are)
3. never prune the parent repo, because this may delete objects other
repos are borrowing
Very infrequently you may consider this extra set of maintenance steps:
1. Find every repo mentioning the parent repository in their alternates
2. Repack them without the -l switch (which copies all the borrowed
objects into those repos)
3. Once all child repos have been repacked this way, prune the parent
repo (it's safe now)
4. Repack child repos again, this time with the -l flag, to get your
savings back.

I would heartily love a way to teach git-repack to recognize when an object it's borrowing from the parent repo is in danger of being pruned. The cheapest way of doing this would probably be to hardlink loose objects into its own objects directory and only consider "safe" objects those that are part of the parent repository's pack. This should make alternates a lot safer, just in case git-prune happens to run by accident.

Show 7 quoted lines
> GVFS uses alternates in this same way: we create a drive-wide "shared
> object cache" that GVFS manages. We put our prefetch packs filled with
> commits and trees in there, and any loose objects that are downloaded
> via the object virtualization are placed as loose objects in the
> alternate. We also store the multi-pack-index and commit-graph in that
> alternate. This means that the only objects in each src dir are those
> created by the developer doing their normal work.

I'm very interested in GVFS, because it would certainly make my life easier maintaining source.codeaurora.org, which is many thousands of repos that are mostly forks of the same stuff. However, GVFS appears to only exist for Windows (hint-hint, nudge-nudge). :)

Best,
-- 
Konstantin Ryabitsev
Director, IT Infrastructure Security
The Linux Foundation
Previous: Derrick StoleeNext: Ævar Arnfjörð Bjarmason
Message 8 of 34 in “worktrees vs. alternates”
  1. Lars SchneiderMay 16, 2018
  2. Ævar Arnfjörð BjarmasonMay 16, 2018
  3. Robert P. J. DayMay 16, 2018
  4. Ævar Arnfjörð BjarmasonMay 16, 2018
  5. Lars SchneiderMay 16, 2018
  6. Ævar Arnfjörð BjarmasonMay 16, 2018
  7. Derrick StoleeMay 16, 2018
  8. Konstantin RyabitsevMay 16, 2018
  9. Ævar Arnfjörð BjarmasonMay 16, 2018
  10. Konstantin RyabitsevMay 16, 2018
  11. Ævar Arnfjörð BjarmasonMay 16, 2018
  12. Martin FickMay 16, 2018
  13. Konstantin RyabitsevMay 16, 2018
  14. Ævar Arnfjörð BjarmasonMay 16, 2018
  15. Konstantin RyabitsevMay 16, 2018
  16. Martin FickMay 16, 2018
  17. Konstantin RyabitsevMay 16, 2018
  18. Martin FickMay 16, 2018
  19. Konstantin RyabitsevMay 16, 2018
  20. Martin FickMay 16, 2018
  21. Jeff KingMay 16, 2018
  22. Konstantin RyabitsevMay 16, 2018
  23. Jeff KingMay 16, 2018
  24. Martin FickMay 16, 2018
  25. Jeff KingMay 16, 2018
  26. Martin FickMay 16, 2018
  27. Konstantin RyabitsevMay 16, 2018
  28. Jeff KingMay 16, 2018
  29. Sitaram ChamartyMay 17, 2018
  30. Jeff KingMay 17, 2018
  31. Duy NguyenMay 19, 2018
  32. Jeff KingMay 16, 2018
  33. Stefan BellerMay 16, 2018
  34. Jeff KingMay 16, 2018

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.