Přeskočit na obsah

Ruční deploy přeskočí migrace druhého (master) schématu — feature padá na „table does not exist“

import { Aside } from ‘@astrojs/starlight/components’;

Uživatel nahraje soubor k záznamu (faktura k provizi) a při uložení dostane chybu. V logu aplikace:

Invalid `prisma.storageReserveLedger.findUnique()` invocation:
The table `public.StorageReserveLedger` does not exist in the current database. (P2021)
… kompenzace NEDOKONČENA v kroku quota

Opakované pokusy nechávají v DB řádky evidence kompenzace ve stavu compensating (soubor smazán, kvóta „neuvolněna“), které nikdo neuklidí.

  1. Multi-tenant aplikace má dvě Prisma schémata: prisma/schema.prisma (tenant DB) a prisma/master/schema.prisma (master DB) a ke každému vlastní migrační runner (migrate-tenants.mjs, migrate-master.mjs). Oficiální deploy skript volá oba, ale ruční „rychlá“ deploy rutina (rsync → migrate-tenants → gated build) volala jen tenantový runner. Master migrace z 22. 8. (nová tabulka pro exactly-once rezervaci kvóty úložiště) se tak nikdy nenasadila; dry-run tenantů hlásil „vše aktuální“, což vytvořilo falešný pocit jistoty.
  2. Feature nahrání souboru byla správně fail-closed (kompenzace: unlink souboru → uvolnění kvóty → smazání evidence), ale sweep kompenzací volal jen integrační test — žádný cron. Nedokončená evidence proto zůstávala navždy.
  • Aplikovat chybějící master migraci (node scripts/migrate-master.mjs), ověřit _prisma_migrations v master DB a existenci tabulky.
  • Sweep kompenzací zapojit do denního dohledu (cron route), selhání sweepu hlásit jako kritický alert.
  • Po migraci spustit jednorázový self-check ledgeru (rezervace → důkaz → uvolnění syntetickým klíčem) a sweep, který doklidí staré řádky.
  • Do gatovaného build skriptu přidat kontrolu: migrate-master --dry-run i migrate-tenants --dry-run; jakákoli čekající migrace ⇒ build se nespustí.
  • grep -c "^(dry-run)" ve výstupu master runneru > 0, zatímco tenant runner hlásí „aktuální“.
  • V master DB chybí poslední záznamy v _prisma_migrations oproti adresáři prisma/master/migrations.
  • Evidence kompenzací (*Compensation tabulka) má řádky starší než lease s attempts > 0 a lastError obsahující P2021.

Dvě schémata = dva runnery = dvě místa, kde se dá zapomenout. Každá deploy cesta (včetně „jen rychlý build“) musí kontrolovat obě, a každá fail-closed kompenzace potřebuje plánovaný sweep, jinak se fail-closed změní v „navždy zaseklé“.

Přidal aiarchitekt.cz · 1. 10. 2026 2:00
Provozuje aiarchitekt.cz