Is there a way to limit the amount of memory that "git gc" uses?
I used instructions from this link. Same idea as Charles Baileys suggested.
A copy of the commands is here:
git config --global pack.windowMemory "100m"
git config --global pack.packSizeLimit "100m"
git config --global pack.threads "1"
This worked for me on hostgator with shared hosting account.
Yes, have a look at the help page for git config
and look at the pack.*
options, specifically pack.depth
, pack.window
, pack.windowMemory
and pack.deltaCacheSize
.
It's not a totally exact size as git needs to map each object into memory so one very large object can cause a lot of memory usage regardless of the window and delta cache settings.
You may have better luck packing locally and transfering pack files to the remote side "manually", adding a .keep
files so that the remote git doesn't ever try to completely repack everything.
Git repack's memory use is: (pack.deltaCacheSize + pack.windowMemory) × pack.threads
. Respective defaults are 256MiB, unlimited, nproc.
The delta cache isn't useful: most of the time is spent computing deltas on a sliding window, the majority of which are discarded; caching the survivors so they can be reused once (when writing) won't improve the runtime. That cache also isn't shared between threads.
By default the window memory is limited through pack.window
(gc.aggressiveWindow
). Limiting packing that way is a bad idea, because the working set size and efficiency will vary widely. It's best to raise both to much higher values and rely on pack.windowMemory
to limit the window size.
Finally, threading has the disadvantage of splitting the working set. Lowering pack.threads
and increasing pack.windowMemory
so that the total stays the same should improve the run time.
repack has other useful tunables (pack.depth
, pack.compression
, the bitmap options), but they don't affect memory use.
You could use turn off the delta attribute to disable delta compression for just the blobs of those pathnames:
In foo/.git/info/attributes
(or foo.git/info/attributes
if it is a bare repository) (see the delta entry in gitattributes and see gitignore for the pattern syntax):
/large_file_dir/* -delta
*.psd -delta
/data/*.iso -delta
/some/big/file -delta
another/file/that/is/large -delta
This will not affect clones of the repository. To affect other repositories (i.e. clones), put the attributes in a .gitattributes
file instead of (or in addition to) the info/attributes
file.
Git 2.18 (Q2 2018) will improve the gc memory consumption.
Before 2.18, "git pack-objects
" needs to allocate tons of "struct object_entry
" while doing its work: shrinking its size helps the performance quite a bit.
This influences git gc
.
See commit f6a5576, commit 3b13a5f, commit 0aca34e, commit ac77d0c, commit 27a7d06, commit 660b373, commit 0cb3c14, commit 898eba5, commit 43fa44f, commit 06af3bb, commit b5c0cbd, commit 0c6804a, commit fd9b1ba, commit 8d6ccce, commit 4c2db93 (14 Apr 2018) by Nguyễn Thái Ngọc Duy (pclouds
).
(Merged by Junio C Hamano -- gitster
-- in commit ad635e8, 23 May 2018)
pack-objects
: reorder members to shrinkstruct object_entry
Previous patches leave lots of holes and padding in this struct.
This patch reorders the members and shrinks the struct down to 80 bytes (from 136 bytes on 64-bit systems, before any field shrinking is done) with 16 bits to spare (and a couple more in in_pack_header_size when we really run out of bits).This is the last in a series of memory reduction patches (see "pack-objects: a bit of document about struct object_entry" for the first one).
Overall they've reduced repack memory size on
linux-2.6.git
from 3.747G to 3.424G, or by around 320M, a decrease of 8.5%.
The runtime of repack has stayed the same throughout this series.
Ævar's testing on a big monorepo he has access to (bigger thanlinux-2.6.git
) has shown a 7.9% reduction, so the overall expected improvement should be somewhere around 8%.
With Git 2.20 (Q4 2018), it will be easier to check an object that exists in one fork is not made into a delta against another object that does not appear in the same forked repository.
See commit fe0ac2f, commit 108f530, commit f64ba53 (16 Aug 2018) by Christian Couder (chriscool
).
Helped-by: Jeff King (peff
), and Duy Nguyen (pclouds
).
See commit 9eb0986, commit 16d75fa, commit 28b8a73, commit c8d521f (16 Aug 2018) by Jeff King (peff
).
Helped-by: Jeff King (peff
), and Duy Nguyen (pclouds
).
(Merged by Junio C Hamano -- gitster
-- in commit f3504ea, 17 Sep 2018)
pack-objects
: move 'layer
' into 'struct packing_data
'
This reduces the size of 'struct object_entry' from 88 bytes to 80 and therefore makes packing objects more efficient.
For example on a Linux repo with 12M objects,
git pack-objects --all
needs extra 96MB memory even if the layer feature is not used.
Note that Git 2.21 (Feb. 2019) fixes a small bug: "git pack-objects
" incorrectly used uninitialized mutex, which has been corrected.
See commit edb673c, commit 459307b (25 Jan 2019) by Patrick Hogg (``).
Helped-by: Junio C Hamano (gitster
).
(Merged by Junio C Hamano -- gitster
-- in commit d243a32, 05 Feb 2019)
pack-objects
: move read mutex topacking_data
struct
ac77d0c ("
pack-objects
: shrink size field in structobject_entry
", 2018-04-14) added an extra usage of read_lock/read_unlock in the newly introducedoe_get_size_slow
for thread safety in parallel calls totry_delta()
.
Unfortunatelyoe_get_size_slow
is also used in serial code, some of which is called before the first invocation ofll_find_deltas
.
As such the read mutex is not guaranteed to be initialized.Resolve this by moving the read mutex to
packing_data
and initializing it in prepare_packing_data which is initialized incmd_pack_objects
.
Git 2.21 (Feb. 2019) still find another way to shrink the size of the pack with "git pack-objects
" learning another algorithm to compute the set of
objects to send, that trades the resulting packfile off to save
traversal cost to favor small pushes.
pack-objects
: createpack.useSparse
setting
The '
--sparse
' flag in 'git pack-objects
' changes the algorithm used to enumerate objects to one that is faster for individual users pushing new objects that change only a small cone of the working directory.
The sparse algorithm is not recommended for a server, which likely sends new objects that appear across the entire working directory.Create a '
pack.useSparse
' setting that enables this new algorithm.
This allows 'git push
' to use this algorithm without passing a '--sparse
' flag all the way through four levels ofrun_command()
calls.If the '
--no-sparse
' flag is set, then this config setting is overridden.
The config pack documentation now includes:
pack.useSparse:
When true, Git will default to using the '
--sparse
' option in 'git pack-objects
' when the '--revs
' option is present.
This algorithm only walks trees that appear in paths that introduce new objects.This can have significant performance benefits when computing a pack to send a small change.
However, it is possible that extra objects are added to the pack-file if the included commits contain certain types of direct renames.
See "git push
is very slow for a huge repo" for a concrete illustration.
Note: as commented in Git 2.24, a setting like pack.useSparse
is still experimental.
See commit aaf633c, commit c6cc4c5, commit ad0fb65, commit 31b1de6, commit b068d9a, commit 7211b9e (13 Aug 2019) by Derrick Stolee (derrickstolee
).
(Merged by Junio C Hamano -- gitster
-- in commit f4f8dfe, 09 Sep 2019)
repo-settings
: createfeature.experimental
setting
The '
feature.experimental
' setting includes config options that are not committed to become defaults, but could use additional testing.Update the following config settings to take new defaults, and to use the
repo_settings
struct if not already using them:
- 'pack.useSparse=true'
- 'fetch.negotiationAlgorithm=skipping'
With Git 2.26 (Q1 2020), The way "git pack-objects
" reuses objects stored in existing pack to generate its result has been improved.
See commit d2ea031, commit 92fb0db, commit bb514de, commit ff48302, commit e704fc7, commit 2f4af77, commit 8ebf529, commit 59b2829, commit 40d18ff, commit 14fbd26 (18 Dec 2019), and commit 56d9cbe, commit bab28d9 (13 Sep 2019) by Jeff King (peff
).
(Merged by Junio C Hamano -- gitster
-- in commit a14aebe, 14 Feb 2020)
pack-objects
: improve partial packfile reuseHelped-by: Jonathan Tan
Signed-off-by: Jeff King
Signed-off-by: Christian Couder
The old code to reuse deltas from an existing packfile just tried to dump a whole segment of the pack verbatim. That's faster than the traditional way of actually adding objects to the packing list, but it didn't kick in very often. This new code is really going for a middle ground: do some per-object work, but way less than we'd traditionally do.
The general strategy of the new code is to make a bitmap of objects from the packfile we'll include, and then iterate over it, writing out each object exactly as it is in our on-disk pack, but not adding it to our packlist (which costs memory, and increases the search space for deltas).
One complication is that if we're omitting some objects, we can't set a delta against a base that we're not sending. So we have to check each object in
try_partial_reuse()
to make sure we have its delta.About performance, in the worst case we might have interleaved objects that we are sending or not sending, and we'd have as many chunks as objects. But in practice we send big chunks.
For instance, packing torvalds/linux on GitHub servers now reused 6.5M objects, but only needed ~50k chunks.
With Git 2.34 (Q4 2021), git repack
itself (used by git gc
) benefits from a reduced memory usage.
See commit b017334, commit a9fd2f2, commit a241878 (29 Aug 2021) by Taylor Blau (ttaylorr
).
(Merged by Junio C Hamano -- gitster
-- in commit 9559de3, 10 Sep 2021)
builtin/pack-objects.c
: remove duplicate hash lookupSigned-off-by: Taylor Blau
In the original code from 08cdfb1 ("pack-objects
--keep-unreachable
", 2007-09-16, Git v1.5.4-rc0 -- merge), we add each object to the packing list with type ``obj->type,
whereobj
comes fromlookup_unknown_object()
.
Unless we had already looked up and parsed the object, this will beOBJ_NONE
.
That's fine, sinceoe_set_type()
sets thetype_valid
bit to '0', and we determine the real type later on.So the only thing we need from the object lookup is access to the
flags
field so that we can mark that we've added the object withOBJECT_ADDED
to avoid adding it again (we can just passOBJ_NONE
directly instead of grabbing it from the object).But
add_object_entry()
already rejects duplicates! This has been the behavior since 7a979d9 ("Thin pack - create packfile with missing delta base.", 2006-02-19, Git v1.3.0-rc1 -- merge), but 08cdfb1 didn't take advantage of it.
Moreover, to do theOBJECT_ADDED
check, we have to do a hash lookup inobj_hash
.So we can drop the
lookup_unknown_object()
call completely, and theOBJECT_ADDED
flag, too, since the spot we're touching here is the only location that checks it.In the end, we perform the same number of hash lookups, but with the added bonus that we don't waste memory allocating an
OBJ_NONE
object (if we were traversing, we'd need it eventually, but the whole point of this code path is not to traverse).
The interaction between fetch.negotiationAlgorithm
and feature.experimental
configuration variables has been corrected with Git 2.36 (Q2 2022).
See commit 714edc6, commit a9a136c, commit a68c5b9 (02 Feb 2022) by Elijah Newren (newren
).
(Merged by Junio C Hamano -- gitster
-- in commit 70ff41f, 16 Feb 2022)
repo-settings
: rename the traditional defaultfetch.negotiationAlgorithm
Signed-off-by: Elijah Newren
Give the traditional default
fetch.negotiationAlgorithm
the name 'consecutive
'.
Also allow a choice of 'default
' to have Git decide between the choices (currently, picking 'skipping
' iffeature.experimental
is true and 'consecutive
' otherwise).
Update the documentation accordingly.
git config
now includes in its man page:
Control how information about the commits in the local repository is sent when negotiating the contents of the packfile to be sent by the server.
- Set to "
consecutive
" to use an algorithm that walks over consecutive commits checking each one.- Set to "
skipping
" to use an algorithm that skips commits in an effort to converge faster, but may result in a larger-than-necessary packfile; or set to "noop
" to not send any information at all, which will almost certainly result in a larger-than-necessary packfile, but will skip the negotiation step.- Set to "default" to override settings made previously and use the default behaviour.
The default is normally "
consecutive
", but iffeature.experimental
is true, then the default is "skipping
".
Unknown values will cause 'git fetch
' to error out (unknown fetch negotiation algorithm
).