Entwickler-Infrastruktur
Payload-Plugin: MongoDB-Backup
Open Source
Die Herausforderung
Payload-CMS-Deployments auf MongoDB hatten bisher keine erstklassige Backup-Erfahrung. Teams verließen sich auf manuelle mongodump-Skripte, zusammengeflickte Cron-Shell-Kommandos oder Drittanbieter-Tools, die erst eine eigene Bootstrap-Datenbank brauchten, bevor überhaupt ein Restore möglich war. Auf Serverless-Plattformen wie Vercel ist ein dauerhaft laufender mongodump-Worker gar nicht erst möglich.
Wenn etwas schiefgeht — eine fehlgeschlagene Migration, ein versehentliches Bulk-Delete, ein fehlerhaftes Skript — stellen Administratoren oft erst nach dem Schaden fest, dass kein aktuelles, verifiziertes Backup und kein klarer Restore-Pfad existieren. Für Agenturen und Kunden auf selbst gehosteter Infrastruktur ist "Ich glaube, wir haben irgendwo ein Backup" kein Wiederherstellungsplan.
Unser Ansatz
Um das zu lösen, haben wir ein Open-Source-Plugin für Payload v3 entwickelt, das Backup und Wiederherstellung als erstklassige Bürger des Admin-Panels behandelt: @trieb.work/payload-plugin-backup-mongodb.
- Keine Meta-Datenbank: Jedes Backup beschreibt sich selbst über seinen Blob-Namen — Typ, Datenbank, Host, Collection-Anzahl und Zeitstempel sind direkt im Dateinamen kodiert. Eine frisch installierte Payload-Instanz kann jedes frühere Archiv direkt aus dem Vercel Blob Storage auflisten und wiederherstellen, ohne dass vorher eine Bootstrap-Datenbank existieren muss.
- Erstklassiges Admin-UX: Ein dediziertes Backups-Dashboard wird vom Plugin mitgeliefert und erscheint direkt unter dem Payload-Dashboard. Teams durchsuchen jedes Archiv zeitlich sortiert, sehen Host und Datenbank auf einen Blick und lösen Download, Restore oder Löschung mit einem Klick aus. Länger laufende Tasks melden ihren Fortschritt über ein kurzlebiges pollSecret und bleiben so auch über Reloads hinweg beobachtbar.
- Zeitgesteuerte und manuelle Backups: /api/backup-mongodb/cron/run lässt sich an Vercel Cron oder jeden anderen HTTP-Scheduler anbinden, um retention-gesteuerte tägliche Archive zu erhalten — die N neuesten Cron-Backups werden behalten, ältere automatisch gelöscht. Manuelle On-Demand-Backups sind ideale Checkpoints vor riskanten Migrationen und werden niemals automatisch entsorgt.
- Selektive Wiederherstellung mit Vorschau pro Collection: Vor jedem Schreibvorgang zeigt das Plugin eine Vorschau des Archivinhalts pro Collection. Alles wiederherstellen, einzelne Collections auswählen oder gebündelte Medien aus einem .tar.gz-Archiv überspringen, wenn nur Datenbankzeilen gebraucht werden — perfekt, um Production in Staging zu klonen.
Selbstbeschreibende Backups — keine Bootstrap-DB nötig
Vorschau-gesteuerte Wiederherstellung aus jedem Archiv
Läuft auf Vercel Cron + Blob und jedem Node-Host
Die Ergebnisse
Agenturen und Self-Hosting-Payload-Betreiber erhalten damit ein produktionsreifes Sicherheitsnetz, ohne eine zweite Datenbank deployen oder externe Backup-Dienste verkabeln zu müssen. Das Plugin ist in unserer eigenen Payblocks-Vorlage im Einsatz und in Kundenprojekten, bei denen ein Fehler im CMS niemals zu einem Ausfall werden darf.
Die Wiederherstellung nach einer fehlgeschlagenen Migration oder einem fehlerhaften Deploy reduziert sich von "Ticket einreichen und hoffen" auf einen Ein-Klick-Restore aus jedem früheren Archiv — selbst auf einer frisch deployten Umgebung, die die Originaldatenbank noch nie gesehen hat. Allein das erlaubt jedem Payload-plus-MongoDB-Team schnellere und mutigere Schema-Iterationen.
Bereit für Ihr Projekt?
Lassen Sie uns besprechen, wie wir Ihre Idee zum Leben erwecken können.