NatLabRockies / NatLabRockies/openstudio-server-helm

Ops rules: Resque silent job loss — mid-ramp dispatch ban + end-of-run sweep

Open Beginner friendly
#119 0 comments 0 reactions 0 assignees View on GitHub

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)

  1. Dispatch/re-dispatch ONLY after fleet fully converged: readyReplicas == desired AND all mounts ls clean. Mid-ramp dispatch caused the 2026-08-24 orphan wave.
  2. After ANY mass recycle: re-dispatch dps with status: started (their children died). queued jobs survive in redis and resume on their own.
  3. End-of-run sweep: any dp not completed + completed normal gets one submit_simulation once 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, collection data_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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.