Thread (3 messages) 3 messages, 3 authors, 2023-07-27

Re: Git monorepo - recommendation regarding usage of sparse-checkout

From: Rudy Rigot <hidden>
Date: 2023-07-27 20:01:44

To add a data point: we have been using sparse checkout in non-cone
mode on our very large repository at Salesforce. Non-cone, because we
are a monolith, 99% of our files are actually needed by our single
build, so we need to process by exclusion. Our repository has been in
production for a bit over a year, with now between 1k and 2k active
collaborators, and the only issue we've seen with sparse checkout, is
when a user really messed something up bad enough in our scripted
environment setup that they end up running a very old version of Git
for some reason. Recent versions have been seamless.

--


On Sat, Jul 8, 2023 at 9:20 PM Sean Allred [off-list ref] wrote:

"Mor, Gil (DXC Luxoft)" [off-list ref] writes:
quoted
Hello, we are experimenting with migrating a large-ish code base from
SVN to a Git Monorepo and it would help us if we can get some input
regarding the usage of sparse-checkout.
We're in the same boat. I haven't been able to keep up with the list as
well as I would like, but I can share our experience so far. We're
writing developer tooling for a team of ~2k devs.
quoted
From our timing experiments sparse-checkout is the only method so far
that reduces our times to good results.
You should also look into sparse-index.
quoted
The only issue might be the Disclaimer that the sparse-checkout
feature is experimental, and that the behavior will change.
It seems vanishingly unlikely that the feature will go away at this
point (even if the CLI changes). We have automated integration tests set
up for our automation and have near-term plans to start running those
against `git.git:main` and `git.git:next`. This way, we'll get advance
notice if something we're relying on starts breaking.
quoted
The command is already featured in GitHub and GitLab articles about
reducing Monorepos size but we are still not sure how un/stable the
feature is or how commonly used the feature is already.
We haven't encountered many issues with stability. There was one issue
a few months back where the pattern syntax changed, but as I recall that
was more of a problem with one of our developers going off the beaten
path and trying to write to GIT_DIR directly instead of using `git
sparse-checkout set` or similar.
quoted
So, we thought we'll write an email to see if we can get a bit more
nuanced answer about the safety of real-world usage so that we can
make an informed decision whether or not to start using
sparse-checkout, despite it being experimental.
One of the goals of our tooling is to teach people how to actually use
Git (i.e., use our tooling to automate the boring stuff -- not to
replace Git itself). To meet this goal, we're using the more 'ergonomic'
git-switch command instead of git-checkout. In our case, as long as we
can react to changes in git-switch syntax (which we haven't seen since
the project started a few years ago) and as long as we can get the same
side-effects, we'll be fine. This comfort is largely driven by the
existence of integration tests.
quoted
We are not looking for 100% assurance, we know the responsibility is
eventually totally ours and there are no guarantees, but it seems like
a game changer so we are just looking for a bit more information so
that we can make a decision.
Sparse checkout is not a silver bullet, but it does make a difference.
We still see commits take several seconds on Windows (even with sparse
index). This is *several orders of magnitude* better than SVN on our
repository (where naive commits on top-level folders can take tens of
minutes), but it's not what folks are going to be expecting from Git. In
the long-term, we're looking at what would be involved in splitting up
our monorepo and seeing whether the rewards really outweigh the costs
(both of which reach far beyond source control).

Best of luck!

--
Sean Allred
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help