vole
Clone
Read only, no credentials:
https://rodent.software/git/vole.git
Write over SSH with a registered key:
git clone ssh://git@0.0.0.0:2222/vole.git
A free and open-source forge that lives in your Git repo.
Apply a push's index delta as the push lands, and check the ref by reading it
dced06da1bfc4a8e542e5d86d67888362077ed39 · Keenan Nemetz · 9d ago · parent 26c9be33
Apply a push's index delta as the push lands, and check the ref by reading it A push's metadata delta used to be applied by the next reader, so the first page after a big push paid for the whole push. And search checked every visible repository before querying: a `symbolic-ref` to open it and a `rev-parse` to see whether the metadata branch moved, so N repositories cost 2N git processes per search. - Post-receive now opens the index (the SSH server hands it `VOLE_INDEX_DB` and the repository id) and runs Ensure after the refs have moved, which is also after a followed request's head has moved. A failure is reported and ignored: the refs have landed, and the next read still repairs it. - `git.Repo.RefCommit` resolves a branch ref by reading the loose ref file git writes for every branch update, and falls back to `rev-parse` for a packed ref, a symbolic ref, or a missing one. The index's Ensure and the web's metadata-head read use it. - `repo.Store.Meta` builds a repository handle without a HEAD lookup, and search uses it: the refresh needs the directory and the ACL, not the default branch. The per-repository check is now two file reads instead of two processes. Load harness, `search-find` at concurrency 4 over three repositories: 510.2 req/s and p50 7 ms before, 814.8 req/s and p50 4 ms after. A push that changes the `vole` branch leaves the rows current before the push returns; a test queries them with no Ensure in between.
docs/architecture.md +6
| @@ -72,6 +72,12 @@ Git holds the repository history. SQLite holds the account database, the CI queu | |||
| 72 | 72 | and records, and generated indexes. Anything that can be rebuilt comes from Git or | |
| 73 | 73 | stored files. Anything that cannot be rebuilt is small and easy to back up. | |
| 74 | 74 | ||
| 75 | The web index is derived from each repository's `vole` branch. Post-receive applies | ||
| 76 | a push's delta as the push lands, so a page does not pay for the work the push | ||
| 77 | already did. Every read still checks the branch it was built from — reading the | ||
| 78 | loose ref, which is a file, rather than starting a process — and repairs the rows | ||
| 79 | if a hook did not run. `vole admin index rebuild` is the last resort. | ||
| 80 | |||
| 75 | 81 | The `vole` branch contains: | |
| 76 | 82 | ||
| 77 | 83 | ```text | |