aboutsummaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorShubham Kanodia <shubham.kanodia10@gmail.com>2024-10-03 08:57:57 +0000
committerJunio C Hamano <gitster@pobox.com>2024-10-03 11:23:09 -0700
commit3d6ab4177ddf63369ce3e7d12a0599724b6fa173 (patch)
treeb1e680ed5ac8f3f038ce96bbb444f3c844f3298a /Documentation
parent4f71522dfb7fc53eff569023303980c66114b1bc (diff)
downloadgit-3d6ab4177ddf63369ce3e7d12a0599724b6fa173.tar.xz
doc: add a note about staggering of maintenance
Git maintenance tasks are staggered to a random minute of the hour per client to avoid thundering herd issues. Updates the doc to add a note about the same. Signed-off-by: Shubham Kanodia <shubham.kanodia10@gmail.com> Acked-by: Derrick Stolee <stolee@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/git-maintenance.txt4
1 files changed, 3 insertions, 1 deletions
diff --git a/Documentation/git-maintenance.txt b/Documentation/git-maintenance.txt
index 9d96819133..6e6651309d 100644
--- a/Documentation/git-maintenance.txt
+++ b/Documentation/git-maintenance.txt
@@ -220,7 +220,9 @@ on an hourly basis. Each run executes the "hourly" tasks. At midnight,
that process also executes the "daily" tasks. At midnight on the first day
of the week, that process also executes the "weekly" tasks. A single
process iterates over each registered repository, performing the scheduled
-tasks for that frequency. Depending on the number of registered
+tasks for that frequency. The processes are scheduled to a random minute of
+the hour per client to spread out the load that multiple clients might
+generate (e.g. from prefetching). Depending on the number of registered
repositories and their sizes, this process may take longer than an hour.
In this case, multiple `git maintenance run` commands may run on the same
repository at the same time, colliding on the object database lock. This