NatLabRockies / NatLabRockies/openstudio-server-helm
Ops rules: Resque silent job loss — mid-ramp dispatch ban + end-of-run sweep
Nobody has claimed this yet.
- Dominant language
- Go Template
- Stars
- 12
- Forks
- 24
- PR merge metrics
- No merged PRs in 30d
Description
Why
HANDOFF-SCALE-TO-9000.md §R7: jobs die silently when worker children die mid-run (verified again 2026-08-24). This is a process contract, not a bug to patch today — but it's currently tribal knowledge in a handoff doc.
The rules (from the handoff, verified)
- Dispatch/re-dispatch ONLY after fleet fully converged:
readyReplicas == desiredAND all mountslsclean. Mid-ramp dispatch caused the 2026-08-24 orphan wave. - After ANY mass recycle: re-dispatch dps with
status: started(their children died).queuedjobs survive in redis and resume on their own. - End-of-run sweep: any dp not
completed+completed normalgets onesubmit_simulationonce the fleet is quiet.
Caveats / gotchas to document
- Beware mongoid cursor weirdness: updating while iterating re-emits updated docs (
#each) — harmless duplicates, app skips completed-normal, but document it so nobody "fixes" it into a livelock. - Mongo access: exec into deploy/db,
mongosh -u openstudio -p <pass> --authenticationDatabase admin os_docker, collectiondata_points.
Deliverable
- Runbook section (or standalone doc) covering the three rules
- Optionally: scripted end-of-run sweep tooling so rule 3 isn't hand-run mongosh
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with HANDOFF-SCALE-TO-9000.md §R7 and compare its three rules with the issue's listed MongoDB and fleet-operation caveats. Add a runbook section or standalone document covering convergence before dispatch, post-recycle redispatch, and the end-of-run sweep; document the cursor behavior and Mongo access details, with sweep tooling optional.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- helm, kubernetes, mongodb, redis
- Domain
- databases, devops, documentation, infrastructure
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 74/100