Orchestrator.RolloutAll wendet eine geordnete Liste von Migrationen auf JEDE
registrierte Tenant-Datenbank an (LoadMigrations liest *.up.sql aus einem
Verzeichnis nach der bestehenden 000N_name-Namenskonvention). Jeder Tenant
laeuft unabhaengig in eigener Verbindung — ein Fehlschlag bei einem Mandanten
bricht nur dessen eigenen Rollout ab (spaetere Migrationen bauen typischerweise
auf frueheren auf) und blockiert die uebrigen Tenants nicht.
schema_migrations-Tabelle pro Tenant-Datenbank (version PK, applied_at,
success, error) haelt den Stand pro Version einzeln nachvollziehbar fest.
Bereits erfolgreiche Versionen werden bei einem erneuten Rollout uebersprungen
(isAlreadySuccessful-Check vor jeder Anwendung), fehlgeschlagene werden beim
naechsten Versuch automatisch erneut probiert (kein manuelles Zuruecksetzen
noetig) — ON CONFLICT DO UPDATE haelt jeweils nur den letzten Versuch fest.
Bewusst ohne Abhaengigkeit von TEN-06 (Router): Migrations-Rollouts sind
seltene Batch-Vorgaenge, ein kurzlebiger Pool pro Tenant und Lauf reicht.
Pruefungen (ausgefuehrt auf root@192.168.1.131, go build/vet/test PASS,
go test ./... mit -p 1 noetig da mehrere Pakete die geteilte Registry-Tabelle
auf derselben Postgres-Instanz nutzen — siehe scripts/reset-test-env.sh):
1. Rollout gegen 3 Test-Tenants, einer absichtlich inkompatibel (Tabellen-
Konflikt bei Migration 2) — TestRolloutAll_IsolatesFailurePerTenant: die
anderen beiden erhalten beide Migrationen, der inkompatible bekommt
Migration 1 trotzdem, scheitert nur an Migration 2, faellt nicht die
anderen um. PASS.
2. Migrationsstand-Abfrage liefert korrekten Stand pro Tenant —
TestStatus_ReflectsPerTenantState: Version 1 success=true, Version 2
success=false mit Fehlertext. PASS.
3. Wiederholter Rollout fuer fehlgeschlagene Migration moeglich, ohne bereits
erfolgreiche erneut anzuwenden — TestRolloutAll_RetryDoesNotReapplySuccessful:
Migration 1 nutzt bewusst kein IF NOT EXISTS, ein Reapply haette den
zweiten Lauf scheitern lassen; zweiter Lauf ist fehlerfrei und wendet nur
die zuvor fehlgeschlagene Version an. PASS.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
