ginnoir
c73338e256
src/lib/dev-login-config.ts — startup assertion: throws if NODE_ENV=production + ENABLE_DEV_LOGIN=true, scoped to runtime (skipped during next build).
Container
scripts/migrate.mjs — runs Drizzle migrations against DATABASE_URL.
deploy/docker-entrypoint.sh — runs migrations then exec node server.js. Skip with RUN_MIGRATIONS=false.
Dockerfile — copies drizzle/, scripts/migrate.mjs, entrypoint into runner stage; ENTRYPOINT now points at the script.
Compose
deploy/compose.yaml — famapp now image: ${FAMAPP_IMAGE:-ghcr.io/ginnoir/famapp:latest} (build still works locally as fallback). Authentik pinned via AUTHENTIK_IMAGE_TAG (default 2024.12.3). New RUN_MIGRATIONS env passed through.
.env.production.example — documents FAMAPP_IMAGE, AUTHENTIK_IMAGE_TAG, RUN_MIGRATIONS.
CI/CD
.github/workflows/ci.yml — push/PR: typecheck + lint + format:check + build.
.github/workflows/release.yml — v* tag: build + push ghcr.io/ginnoir/famapp:vX.Y.Z, :X.Y, :latest to GHCR.
Docs
deploy/README.md — full deploy/rollback/release runbook.
CHANGELOG.md — release log seeded with an Unreleased entry.
docs/tasks/09-pre-deploy-checklist.md — task 09 reframed from one-shot removal to a recurring pre-deploy checklist.
STATUS.md — updated.
Verified: pnpm typecheck, pnpm format, pnpm build, and docker compose config all clean.
1.8 KiB
1.8 KiB
09 — Pre-deploy checklist (recurring)
Run this before every production deploy (first deploy and each tagged release). Dev-login is intentionally retained behind a double gate; this checklist is what keeps that gate honest.
Env hygiene
- Server
.env(next todeploy/compose.yaml) does not set:ENABLE_DEV_LOGINDEV_LOGIN_EMAIL,DEV_LOGIN_NAME,DEV_HOUSEHOLD_NAME
- Server
.envsets real values for:NEXT_PUBLIC_APP_URL(https)AUTH_SECRET(openssl rand -base64 32)AUTH_OIDC_ISSUER,AUTH_OIDC_CLIENT_ID,AUTH_OIDC_CLIENT_SECRETVAPID_PUBLIC_KEY,VAPID_PRIVATE_KEY,VAPID_SUBJECTFAMAPP_DB_*,AUTHENTIK_DB_*,AUTHENTIK_SECRET_KEY
FAMAPP_IMAGEpins a specific version tag (ghcr.io/ginnoir/famapp:vX.Y.Z), notlatest, after first deploy.
Code-side guard
src/lib/dev-login-config.ts throws on import if NODE_ENV=production and ENABLE_DEV_LOGIN=true. Container will refuse to start.
- Confirm guard is still present (do not remove without updating this checklist).
Smoke after deploy
https://fam.ginnoir.com/loginshows only Sign in with SSO (no Dev login button).- Real Authentik sign-in succeeds, lands on dashboard.
- First user appears in DB with household membership, default calendars, default lists.
- No
dev@famapp.localrow in productionuserstable. - Push opt-in works (settings → enable → test notification arrives).
- A share link created from
/settingsresolves at/s/<token>while signed out.
Backup / rollback
- Last
famapp-backupcron run succeeded (check container logs). - Previous image tag is known and recorded in
CHANGELOG.md, so rollback = bumpFAMAPP_IMAGEanddocker compose up -d famapp.