fix: keep hoogle image haddock from hanging in CI - #5474
Merged
Conversation
zebot
added
the
ok-to-test
akshaymankar
approved these changes
Aug 25, 2026
galley's haddock has hung indefinitely in the upload-hoogle-nix CI job right before 'Documentation created', timing the task out after 1h10m. The hoogle job is the only CI producer of -doc outputs, so the failure loop is self-sustaining whenever galley changes. Scope haddock for the hoogle image set only: disable the quickjump index (unused for hoogle search) and render serially (parallel haddock -j$NIX_BUILD_CORES is the prime deadlock suspect). Production images (imagesNoDocs, enableDocs = false) and dev docs are unaffected. Verified locally: hoogleImage builds in 24m36s (CI budget 50m) with hyperlinked source intact, galley haddockPhase 1m12s, hoogle DB intact.
blackheaven
force-pushed
the
hoogle-haddock-hang-fix
branch
from
August 25, 2026 14:00
e32cd7a to
305790f
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
The
upload-hoogle-nixConcourse job regularly hangs: ~20 min of real build work, then silence until the 1h10m task ...imagesNoDocs(enableDocs = false), so this job is the only CI...--hoogle --quickjump --hyperlink-source -j4) in final render. No local ...Change
nix/wire-server.nix: newhoogleHaddockOverridesapplied via.extendto the hoogle package set only:doHaddockQuickjump = false— quickjump index unused byhoogle server --localdisableParallelBuilding— serial haddock (parallel-j$NIX_BUILD_CORESis the prime deadlock suspect; also seria...Scoped to the hoogle image only; production images (
imagesNoDocs) and dev docs (haskellPackages) keep full haddoc...Verification
nix build -L --fallback .#wireServer.hoogleImage: exit 0 in 24m36s (CI budget ≤ 50m), hyperlinked source intact, incl. `building hoogle ...galley> Documentation created: …galley.txt,galley> haddockPhase completed in 1m12sgalley.txtstill contains 36Galley.API.Teamsentriesnix flake check: fails identically on cleandevelop(packages.x86_64-linux.pkgs is not a derivation) — pre-ex...