Auto-apply migrations on deploy (entrypoint + one-shot service) #23

2026-06-07T10:51:41-04:00

justin commented

2026-06-07 10:51:41 -04:00

Backend entrypoint runs alembic upgrade head (RUN_MIGRATIONS=1) before uvicorn so a Watchtower image swap self-migrates; plus a one-shot migrate service for compose up. Idempotent + serialized so alembic never runs concurrently. Activating needs the updated compose on the host once.

justin added 1 commit 2026-06-07 10:51:41 -04:00

Auto-apply migrations on deploy (entrypoint + one-shot service) 7f640649b9

So a deploy never needs a manual `alembic upgrade head`:

- Backend image gains an entrypoint that runs `alembic upgrade head` before
  uvicorn when RUN_MIGRATIONS=1 (set on the backend service). This self-migrates
  even on a Watchtower in-place image swap, which doesn't re-run one-shot jobs.
- A one-shot `migrate` service covers the `docker compose up` path; backend and
  worker depend on it completing, which also serializes it with the backend
  entrypoint so alembic never runs concurrently. `upgrade head` is idempotent.

Activating this needs the updated compose on the host once (Watchtower only
swaps images, not the compose file / env). After that, migrations are automatic.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

justin merged commit 9ee960c4ef into main

2026-06-07 10:54:32 -04:00

justin deleted branch deploy-auto-migrate

2026-06-07 10:54:32 -04:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: justin/provenance#23