Backup und Upgrade
Docuvate speichert Metadaten in PostgreSQL und Dateien in MinIO. Planen Sie Backups beider Ebenen und führen Sie Schema-Änderungen über TypeORM-Migrationen aus.
Was sichern?
- PostgreSQL-Volume (
pgdata): Benutzer, Labels, Dokumentmetadaten, Embeddings. - MinIO-Volume (
miniodata): Dokument-Blobs. - Optional Worker-ML-Cache (
workermlcache): beschleunigt Rebuilds, nicht zwingend für Datenwiederherstellung.
Migrationen
Schema-Änderungen sind TypeORM-Migrationen mit up und down in apps/api. Die API startet keine Migrationen automatisch (migrationsRun: false).
In Docker Compose übernimmt der einmalige migrate-Service das Upgrade vor API und Worker. Lokal: pnpm db:migrate mit gesetzter DATABASE_URL.
Upgrade-Ablauf
Der db-storage-guard stoppt den Start, wenn Postgres leer ist, aber der MinIO-Bucket noch Dateien enthält (häufig nach Projekt-Umbenennung). Nur mit DOCUVATE_FRESH_STACK=1 bewusst überschreiben.
- Backup von Postgres und MinIO erstellen.
- Neues Image bauen oder pullen,
docker compose up --build(Migrate-Job muss erfolgreich sein). - Release Notes und OpenAPI auf Breaking Changes prüfen; SDK bei Bedarf neu generieren.