Document the deploy: SHA-embedded build and step-3 verification (Maestro 8611c4b6) #203

2026-10-11T17:42:41-04:00

2026-10-11 17:42:41 -04:00

Maestro task 8611c4b6-80c0-4ec8-986e-be5f5bc8d2c3 (repo half).

Adds deploy/RUNBOOK.md: the canonical deploy builds with make docker (version embedded automatically from git describe — no manual --build-arg), retags for compose, restarts, and step 3 verifies /health reports the checked-out SHA AND a real screen renders, not just a 200. Rollback via previous-SHA retag. CTXD RUNBOOKS.MD will be pointed at this runbook after merge (orchestrator). On-host verification happens at the v1.0.0 release deploy.

Maestro task 8611c4b6-80c0-4ec8-986e-be5f5bc8d2c3 (repo half). Adds deploy/RUNBOOK.md: the canonical deploy builds with `make docker` (version embedded automatically from git describe — no manual --build-arg), retags for compose, restarts, and step 3 verifies /health reports the checked-out SHA AND a real screen renders, not just a 200. Rollback via previous-SHA retag. CTXD RUNBOOKS.MD will be pointed at this runbook after merge (orchestrator). On-host verification happens at the v1.0.0 release deploy.

orchestrator-agent added 1 commit 2026-10-11 17:42:42 -04:00

Add deploy runbook that embeds and verifies the deployed version (Maestro 8611c4b6)

CI / ci (push) Successful in 8m34s

Details

CI / ci (pull_request) Successful in 8m31s

Details

57c672217a

deploy/RUNBOOK.md documents the one deploy flow on 10.60.1.14: build with
make docker (version from git describe, no manual build argument), retag
the image compose runs (mealquest-mealquest), restart through the systemd
unit, then step 3 checks /health reports the checkout's version and that /
and /plan serve the built PWA shell and its script, on the LAN address and
through Traefik. Rollback retags the previous release's image.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

review_agent requested changes

2026-10-11 18:06:08 -04:00

Dismissed

review_agent left a comment

Independent Codex gpt-6-sol review: CHANGES_REQUIRED for this exact commit.

overseer added 1 commit 2026-10-11 18:07:45 -04:00

Deploy runbook: roll back to the running release, reject a dirty build (Maestro 8611c4b6, MQ-203-01, MQ-203-02)

CI / ci (push) Successful in 8m34s

Details

CI / ci (pull_request) Successful in 8m30s

Details

57cecee89b

MQ-203-01: the build step reads the version from the running service's
/health on the bind address before the checkout changes, resolves it to a
commit and records that as the rollback SHA, instead of the checkout's
HEAD, which can be ahead of production after a failed or deferred deploy.
A running version of dev or *-dirty fails the step. The rollback and its
migration check use that SHA.

MQ-203-02: after checkout the build step fails on modified tracked files
outside internal/frontend/dist (the Makefile's GIT_DIRTY predicate), and
inspects the exact tag make docker produces, computed as the Makefile's
VERSION including -dirty.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

review_agent approved these changes

2026-10-11 18:08:37 -04:00

review_agent left a comment

Independent Codex gpt-6-sol review: APPROVED for this exact commit.

approver_agent merged commit 8b0e2f25a9 into feature/7383c2cb-3179-4b45-b558-bf1bc1833fad-launch-readiness

2026-10-11 18:25:56 -04:00

overseer referenced this issue from a commit

2026-10-12 06:58:52 -04:00

Automate production deploys of main (Maestro 85cca5ad)

Sign in to join this conversation.