user/dev discussion of public-inbox itself
 help / color / mirror / code / Atom feed
* [PATCH 00/95] clone: multi-inbox/repo support...
@ 2022-11-28  5:30 Eric Wong
  2022-11-28  5:30 ` [PATCH 01/95] clone: support multi-inbox clone Eric Wong
                   ` (94 more replies)
  0 siblings, 95 replies; 96+ messages in thread
From: Eric Wong @ 2022-11-28  5:30 UTC (permalink / raw)
  To: meta

A large patchset, and not done, yet :P  It's only tested live,
but it seems to work reasonably well against live hosts...

Behavior changes to public-inbox-clone are NOT final; but
public-inbox-fetch|PublicInbox::Fetch will probably become
thin wrappers around LeiMirror.

--include=/--exclude= support now exists with glob support

--keep-going and --dry-run support added, too, since it's
make(1) influenced (more below)

It supports coderepos, too, using --inbox-config=never (default: always);
--project-list=, --manifest=, --objstore=, and --prune.

key differences from grok-pull (grokmirror) for coderepos:

* uses relative paths on the FS (dumb HTTP untested, but dumb
  HTTP is a goal for memory-constrained hosts).  This means
  I can relocate coderepos freely within my FS or do sneakernet
  transfers across machines without having to `perl -ipe s/x/y/'
  on hundreds of info/alternates and config files.

* CLI-only, no extra config files (may generate a Makefile, like
  individual inbox clones)

* objstore repos fetches from remotes directly
  (does not need, use, nor benefit from hardlinks at all)

* no sleep states

It is not a full replacement for grokmirror

* reliant on default `git gc' behavior for repack. This is OK
  since it's only one-way relationships between objstore and
  non-objstore repos.

* no fsck support (probably will be in generated Makefile)

* doesn't generate forkgroups nor manifest.js.gz
  (I may do this for coderepo Xapian indexing)

It relies on parallel git-fetch for objstores, so `-j $NUM'
calculations may end up being ($NUM * $NUM) in the worst case.
Not sure how to best approach this...
Maybe `-j $M,$N' similar to `lei q -j$M,$N` is a solution...

Design note:

This is an exercise in building make(1)-like parallelism using
->DESTROY callbacks for prerequisites; so it's a newish paradigm
for me.  It forced me to fix a reference cycle, already.

TODO: repo|symlink pruning, --exit-code, retry/refetch, manpage updates

Eric Wong (95):
  clone: support multi-inbox clone
  clone: support --include and --exclude with multi-clone
  clone: parallelize v2 epoch clones
  lei_mirror: async config retrieval for v2 w/ manifest
  lei_mirror: rely on DESTROY to index v2 inbox
  lei_mirror: rely on global process reaper
  clone: support parallel v1 clones
  lei_mirror: default to single job by default
  lei_mirror: move directory creation to v2-only path
  lei_mirror: retrieve description text asynchronously, too
  switch inotify/kevent stuff to v5.12
  manifest: update module blurb + v5.12
  lei_mirror: simplify _get_txt_start callers
  lei_mirror: elide description retrieval for v1|coderepo
  lei_mirror: add a hint for skipped epoch permissions
  lei_mirror: consolidate clone process management
  lei_mirror: load File::Path unconditionally
  lei_mirror: load most modules up-front
  lei_mirror: set gitweb.owner from manifest
  clone: support --dry-run / -n flag
  lei_mirror: initialize placeholders with "head" from manifest
  lei_mirror: support {reference} for v1 manifest clones
  lei_mirror: reduce noise on interrupted clones
  clone: support --inbox-config option
  lei_mirror: retrieve v2 description properly
  lei_mirror: reduce scope of v2 lock
  lei_mirror: allow --epoch on mixed v1/v2 clones
  lei_mirror: fix infinite loop in dependency resolution
  lei_mirror: defend against infinite loops
  lei_mirror: do not fetch descriptions if using manifest
  lei_mirror: require PublicInbox::Lock at use
  lei_mirror: fix glob semantics to match end-of-path
  lei_mirror: differentiate -entv vs -ent
  lei_mirror: support manifest {references} for v2 epochs
  lei_mirror: simplify v2 code paths
  clone: support --inbox-version
  lei_mirror: require Perl v5.12+
  lei_mirror: ensure curl exits 22 on HTTP 404 responses
  lei_mirror: cleanup File::Temp OO usage
  lei_mirror: add `index' target to generated Makefile
  lei_mirror: do not write Makefile for --inbox-config=never
  lei_mirror: hoist out dump_manifest sub
  lei_mirror: avoid convoluted lazy_cb usage
  lei_mirror: simplify clone_v2_prep
  lei_mirror: support --objstore and forkgroups
  lei_mirror: cleanup process reaping logic
  lei_mirror: ensure git <1.8.5 fallback can use torsocks
  clone: flesh out --objstore behavior and document
  lei_mirror: always pack refs for coderepos
  lei_mirror: set description for non-inboxes, too
  lei_mirror: force --no-tags when fetching forkgroups
  lei_mirror: preserve permissions of existing alternates file
  lei_mirror: do not show ref updates w/o --verbose
  lei_mirror: drop git <1.8.5 support
  lei_mirror: make basename more descriptive
  lei_mirror: fix --dry-run for forkgroups
  lei_mirror: forkgroups use `git fetch --multiple'
  clone: move --dry-run handling to lei_mirror
  clone: drop unnecessary requires
  clone: use v5.12
  clone: require `--objstore=' for default location
  lei_mirror: shorten remote names
  fetch: use v5.12
  fetch: eliminate File::Temp->filename var
  lei_mirror: properly pack-refs in non-forkgroup repos
  lei_mirror: show child error error code
  on_destroy: support ->cancel callback
  lei_mirror: support resuming multi-repo clones
  lei_mirror: check fingerprints before fetching
  clone: support loading manifest.js.gz from destination
  lei_mirror: delay configuring forkgroups
  clone: canonicalize destination path from CLI
  clone|fetch: support passing --prune(-tags) to `git fetch'
  lei_mirror: avoid needless FD passing
  clone: support --keep-going/-k like make(1)
  lei_mirror: don't warn on missing manifest on initial clone
  lei_mirror: respect `./' and `../' prefixes for CLI args
  lei_mirror: --manifest= affects destination, too
  lei_mirror: update fingerprints when writing local manifest.js.gz
  lei_mirror: remove janky mirror.done stamp file
  lei_mirror: simplify most process spawning
  lei_mirror: run v1_done earlier on forkgroup done
  lei_mirror: simplify forkgroup-related subs
  lei_mirror: shorten scope mirror objects
  lei_mirror: set {head} from manifest
  lei_mirror: support {symlinks} from manifest
  lei_mirror: eliminate circular references
  lei_mirror: use curl -z/--timecond if manifest exists
  lei_mirror: avoid redundant curl `-f' use
  lei_mirror: omit trailing slash for git remote.*.url
  lei_mirror: set info/web/last-modified from manifest
  lei_mirror: don't clobber inbox.config.example if it exists
  lei_mirror: break out of fgrp fetch iteration early
  clone: support --project-list= for cgit
  lei_mirror: handle forkgroup changes

 Documentation/lei-add-external.pod   |    4 +-
 Documentation/public-inbox-clone.pod |   76 ++
 Documentation/public-inbox-fetch.pod |    6 +
 lib/PublicInbox/DSKQXS.pm            |    5 +-
 lib/PublicInbox/DirIdle.pm           |    4 +-
 lib/PublicInbox/FakeInotify.pm       |   13 +-
 lib/PublicInbox/Fetch.pm             |   50 +-
 lib/PublicInbox/In2Tie.pm            |    4 +-
 lib/PublicInbox/InboxIdle.pm         |    2 +-
 lib/PublicInbox/KQNotify.pm          |   12 +-
 lib/PublicInbox/LEI.pm               |    5 +-
 lib/PublicInbox/LeiMirror.pm         | 1104 +++++++++++++++++++++-----
 lib/PublicInbox/ManifestJsGz.pm      |    8 +-
 lib/PublicInbox/OnDestroy.pm         |    5 +-
 lib/PublicInbox/TestCommon.pm        |    1 +
 script/public-inbox-clone            |   23 +-
 script/public-inbox-fetch            |    4 +-
 t/on_destroy.t                       |    8 +-
 t/www_listing.t                      |   71 +-
 19 files changed, 1148 insertions(+), 257 deletions(-)

^ permalink raw reply	[flat|nested] 96+ messages in thread

end of thread, other threads:[~2022-11-28  5:32 UTC | newest]

Thread overview: 96+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-11-28  5:30 [PATCH 00/95] clone: multi-inbox/repo support Eric Wong
2022-11-28  5:30 ` [PATCH 01/95] clone: support multi-inbox clone Eric Wong
2022-11-28  5:30 ` [PATCH 02/95] clone: support --include and --exclude with multi-clone Eric Wong
2022-11-28  5:31 ` [PATCH 03/95] clone: parallelize v2 epoch clones Eric Wong
2022-11-28  5:31 ` [PATCH 04/95] lei_mirror: async config retrieval for v2 w/ manifest Eric Wong
2022-11-28  5:31 ` [PATCH 05/95] lei_mirror: rely on DESTROY to index v2 inbox Eric Wong
2022-11-28  5:31 ` [PATCH 06/95] lei_mirror: rely on global process reaper Eric Wong
2022-11-28  5:31 ` [PATCH 07/95] clone: support parallel v1 clones Eric Wong
2022-11-28  5:31 ` [PATCH 08/95] lei_mirror: default to single job by default Eric Wong
2022-11-28  5:31 ` [PATCH 09/95] lei_mirror: move directory creation to v2-only path Eric Wong
2022-11-28  5:31 ` [PATCH 10/95] lei_mirror: retrieve description text asynchronously, too Eric Wong
2022-11-28  5:31 ` [PATCH 11/95] switch inotify/kevent stuff to v5.12 Eric Wong
2022-11-28  5:31 ` [PATCH 12/95] manifest: update module blurb + v5.12 Eric Wong
2022-11-28  5:31 ` [PATCH 13/95] lei_mirror: simplify _get_txt_start callers Eric Wong
2022-11-28  5:31 ` [PATCH 14/95] lei_mirror: elide description retrieval for v1|coderepo Eric Wong
2022-11-28  5:31 ` [PATCH 15/95] lei_mirror: add a hint for skipped epoch permissions Eric Wong
2022-11-28  5:31 ` [PATCH 16/95] lei_mirror: consolidate clone process management Eric Wong
2022-11-28  5:31 ` [PATCH 17/95] lei_mirror: load File::Path unconditionally Eric Wong
2022-11-28  5:31 ` [PATCH 18/95] lei_mirror: load most modules up-front Eric Wong
2022-11-28  5:31 ` [PATCH 19/95] lei_mirror: set gitweb.owner from manifest Eric Wong
2022-11-28  5:31 ` [PATCH 20/95] clone: support --dry-run / -n flag Eric Wong
2022-11-28  5:31 ` [PATCH 21/95] lei_mirror: initialize placeholders with "head" from manifest Eric Wong
2022-11-28  5:31 ` [PATCH 22/95] lei_mirror: support {reference} for v1 manifest clones Eric Wong
2022-11-28  5:31 ` [PATCH 23/95] lei_mirror: reduce noise on interrupted clones Eric Wong
2022-11-28  5:31 ` [PATCH 24/95] clone: support --inbox-config option Eric Wong
2022-11-28  5:31 ` [PATCH 25/95] lei_mirror: retrieve v2 description properly Eric Wong
2022-11-28  5:31 ` [PATCH 26/95] lei_mirror: reduce scope of v2 lock Eric Wong
2022-11-28  5:31 ` [PATCH 27/95] lei_mirror: allow --epoch on mixed v1/v2 clones Eric Wong
2022-11-28  5:31 ` [PATCH 28/95] lei_mirror: fix infinite loop in dependency resolution Eric Wong
2022-11-28  5:31 ` [PATCH 29/95] lei_mirror: defend against infinite loops Eric Wong
2022-11-28  5:31 ` [PATCH 30/95] lei_mirror: do not fetch descriptions if using manifest Eric Wong
2022-11-28  5:31 ` [PATCH 31/95] lei_mirror: require PublicInbox::Lock at use Eric Wong
2022-11-28  5:31 ` [PATCH 32/95] lei_mirror: fix glob semantics to match end-of-path Eric Wong
2022-11-28  5:31 ` [PATCH 33/95] lei_mirror: differentiate -entv vs -ent Eric Wong
2022-11-28  5:31 ` [PATCH 34/95] lei_mirror: support manifest {references} for v2 epochs Eric Wong
2022-11-28  5:31 ` [PATCH 35/95] lei_mirror: simplify v2 code paths Eric Wong
2022-11-28  5:31 ` [PATCH 36/95] clone: support --inbox-version Eric Wong
2022-11-28  5:31 ` [PATCH 37/95] lei_mirror: require Perl v5.12+ Eric Wong
2022-11-28  5:31 ` [PATCH 38/95] lei_mirror: ensure curl exits 22 on HTTP 404 responses Eric Wong
2022-11-28  5:31 ` [PATCH 39/95] lei_mirror: cleanup File::Temp OO usage Eric Wong
2022-11-28  5:31 ` [PATCH 40/95] lei_mirror: add `index' target to generated Makefile Eric Wong
2022-11-28  5:31 ` [PATCH 41/95] lei_mirror: do not write Makefile for --inbox-config=never Eric Wong
2022-11-28  5:31 ` [PATCH 42/95] lei_mirror: hoist out dump_manifest sub Eric Wong
2022-11-28  5:31 ` [PATCH 43/95] lei_mirror: avoid convoluted lazy_cb usage Eric Wong
2022-11-28  5:31 ` [PATCH 44/95] lei_mirror: simplify clone_v2_prep Eric Wong
2022-11-28  5:31 ` [PATCH 45/95] lei_mirror: support --objstore and forkgroups Eric Wong
2022-11-28  5:31 ` [PATCH 46/95] lei_mirror: cleanup process reaping logic Eric Wong
2022-11-28  5:31 ` [PATCH 47/95] lei_mirror: ensure git <1.8.5 fallback can use torsocks Eric Wong
2022-11-28  5:31 ` [PATCH 48/95] clone: flesh out --objstore behavior and document Eric Wong
2022-11-28  5:31 ` [PATCH 49/95] lei_mirror: always pack refs for coderepos Eric Wong
2022-11-28  5:31 ` [PATCH 50/95] lei_mirror: set description for non-inboxes, too Eric Wong
2022-11-28  5:31 ` [PATCH 51/95] lei_mirror: force --no-tags when fetching forkgroups Eric Wong
2022-11-28  5:31 ` [PATCH 52/95] lei_mirror: preserve permissions of existing alternates file Eric Wong
2022-11-28  5:31 ` [PATCH 53/95] lei_mirror: do not show ref updates w/o --verbose Eric Wong
2022-11-28  5:31 ` [PATCH 54/95] lei_mirror: drop git <1.8.5 support Eric Wong
2022-11-28  5:31 ` [PATCH 55/95] lei_mirror: make basename more descriptive Eric Wong
2022-11-28  5:31 ` [PATCH 56/95] lei_mirror: fix --dry-run for forkgroups Eric Wong
2022-11-28  5:31 ` [PATCH 57/95] lei_mirror: forkgroups use `git fetch --multiple' Eric Wong
2022-11-28  5:31 ` [PATCH 58/95] clone: move --dry-run handling to lei_mirror Eric Wong
2022-11-28  5:31 ` [PATCH 59/95] clone: drop unnecessary requires Eric Wong
2022-11-28  5:31 ` [PATCH 60/95] clone: use v5.12 Eric Wong
2022-11-28  5:31 ` [PATCH 61/95] clone: require `--objstore=' for default location Eric Wong
2022-11-28  5:31 ` [PATCH 62/95] lei_mirror: shorten remote names Eric Wong
2022-11-28  5:32 ` [PATCH 63/95] fetch: use v5.12 Eric Wong
2022-11-28  5:32 ` [PATCH 64/95] fetch: eliminate File::Temp->filename var Eric Wong
2022-11-28  5:32 ` [PATCH 65/95] lei_mirror: properly pack-refs in non-forkgroup repos Eric Wong
2022-11-28  5:32 ` [PATCH 66/95] lei_mirror: show child error error code Eric Wong
2022-11-28  5:32 ` [PATCH 67/95] on_destroy: support ->cancel callback Eric Wong
2022-11-28  5:32 ` [PATCH 68/95] lei_mirror: support resuming multi-repo clones Eric Wong
2022-11-28  5:32 ` [PATCH 69/95] lei_mirror: check fingerprints before fetching Eric Wong
2022-11-28  5:32 ` [PATCH 70/95] clone: support loading manifest.js.gz from destination Eric Wong
2022-11-28  5:32 ` [PATCH 71/95] lei_mirror: delay configuring forkgroups Eric Wong
2022-11-28  5:32 ` [PATCH 72/95] clone: canonicalize destination path from CLI Eric Wong
2022-11-28  5:32 ` [PATCH 73/95] clone|fetch: support passing --prune(-tags) to `git fetch' Eric Wong
2022-11-28  5:32 ` [PATCH 74/95] lei_mirror: avoid needless FD passing Eric Wong
2022-11-28  5:32 ` [PATCH 75/95] clone: support --keep-going/-k like make(1) Eric Wong
2022-11-28  5:32 ` [PATCH 76/95] lei_mirror: don't warn on missing manifest on initial clone Eric Wong
2022-11-28  5:32 ` [PATCH 77/95] lei_mirror: respect `./' and `../' prefixes for CLI args Eric Wong
2022-11-28  5:32 ` [PATCH 78/95] lei_mirror: --manifest= affects destination, too Eric Wong
2022-11-28  5:32 ` [PATCH 79/95] lei_mirror: update fingerprints when writing local manifest.js.gz Eric Wong
2022-11-28  5:32 ` [PATCH 80/95] lei_mirror: remove janky mirror.done stamp file Eric Wong
2022-11-28  5:32 ` [PATCH 81/95] lei_mirror: simplify most process spawning Eric Wong
2022-11-28  5:32 ` [PATCH 82/95] lei_mirror: run v1_done earlier on forkgroup done Eric Wong
2022-11-28  5:32 ` [PATCH 83/95] lei_mirror: simplify forkgroup-related subs Eric Wong
2022-11-28  5:32 ` [PATCH 84/95] lei_mirror: shorten scope mirror objects Eric Wong
2022-11-28  5:32 ` [PATCH 85/95] lei_mirror: set {head} from manifest Eric Wong
2022-11-28  5:32 ` [PATCH 86/95] lei_mirror: support {symlinks} " Eric Wong
2022-11-28  5:32 ` [PATCH 87/95] lei_mirror: eliminate circular references Eric Wong
2022-11-28  5:32 ` [PATCH 88/95] lei_mirror: use curl -z/--timecond if manifest exists Eric Wong
2022-11-28  5:32 ` [PATCH 89/95] lei_mirror: avoid redundant curl `-f' use Eric Wong
2022-11-28  5:32 ` [PATCH 90/95] lei_mirror: omit trailing slash for git remote.*.url Eric Wong
2022-11-28  5:32 ` [PATCH 91/95] lei_mirror: set info/web/last-modified from manifest Eric Wong
2022-11-28  5:32 ` [PATCH 92/95] lei_mirror: don't clobber inbox.config.example if it exists Eric Wong
2022-11-28  5:32 ` [PATCH 93/95] lei_mirror: break out of fgrp fetch iteration early Eric Wong
2022-11-28  5:32 ` [PATCH 94/95] clone: support --project-list= for cgit Eric Wong
2022-11-28  5:32 ` [PATCH 95/95] lei_mirror: handle forkgroup changes Eric Wong

Code repositories for project(s) associated with this public inbox

	https://80x24.org/public-inbox.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).