Document rolling-target readiness in the deploy runbook

472cfe3e7827 · Devin AI · · parent a79bfce11b00

Document rolling-target readiness in the deploy runbook

Co-Authored-By: Christopher David <chris@openagents.com>
Co-Authored-By
Christopher David <chris@openagents.com>

Deploy story

What this commit did to the running system — joined from the forge receipt chain, the part a commit page elsewhere cannot show.

built
21 modules in 106.8 s
deployed
live · 21 modules on 3 nodes · push→live —
deployed
needs_rolling_replace · 21 modules on 0 nodes · push→live —

Changed files

  • modified docs/operations/production-deploy-runbook.md

Diff

1 file changed, +9 -0

docs/operations/production-deploy-runbook.md modified +9

@@ -236,6 +236,15 @@ Requirements before pointing the backend at the HTTP check:

236 236
     --health-checks sarah-hc-tcp --global-health-checks
237 237
   ```
238 238
239
With the HTTP check active, a structural rolling replacement depends on
240
boot convergence accepting a node that runs the newest
241
`needs_rolling_replace` target's image. Nodes replaced before settlement
242
report `image_matches_rolling_target` and stay in rotation; settlement
243
through `finish_rolling_replacement/2` flips the target live and the next
244
convergence attempt reports `image_matches_live`. Images older than commit
245
`a79bfce` degrade with `artifact_not_direct` instead and return `503` for
246
the whole roll, which would empty the backend.
247
239 248
## Known failure modes
240 249
241 250
| Symptom | Cause | Fix |

This page updates live while a promote is in flight · changelog