Backups erstellen und verwalten mit WP-CLI

Mit wp cloneworx-backup backup startest Du ein Backup ohne Plan und verwaltest die Backups der Liste: zeigen, sperren, prüfen, herunterladen, löschen. wp cloneworx-backup retention zeigt, welche alten Backups wegfallen, und löscht sie auf Wunsch sofort.

WP-CLI fehlt noch? Die Anleitung steht in WP-CLI installieren. Alle Befehle des Plugins nennt Die Befehle im Überblick.

Das gilt für alle Aktionen

• Ein Backup nennst Du mit seinem Job-Namen: Datum, Uhrzeit und eine Kennung aus 32 Zeichen. Den Job-Namen zeigt backup list. In den Beispielen steht dafür <Job>.
• Ein Ziel nennst Du in --targets mit seiner Kennung, zum Beispiel local-1. Die Kennungen zeigt wp cloneworx-backup target list.
• Je Website läuft immer nur ein Job. Läuft schon einer, endet jeder Befehl, der einen Job startet, mit einem Fehler und nennt den laufenden Job.
• Die Ausgaben der Befehle sind englisch.
• backup run, backup check, backup delete und retention run prüfen zuerst den Benutzer: Der Befehl muss als der Benutzer laufen, dem die Ordner des Plugins gehören. Dateien, die ein anderer Benutzer anlegt, könnte die Website später nicht mehr ändern oder löschen. --force übergeht die Prüfung.

Ein Backup ohne Plan starten: run

backup run startet sofort ein Backup und treibt es in diesem Prozess bis zum Ende. Das Backup gehört zu keinem Plan. Einen Backup-Plan führst Du mit wp cloneworx-backup plan run aus; mehr dazu in Backup-Pläne verwalten mit WP-CLI.

Schalter	Bedeutung	Erlaubte Werte
--roots	Was gesichert wird. Ohne den Schalter sichert das Plugin alles.	Wurzeln, durch Komma getrennt: db, wp-config, wp-content, wp-core, wp-mu-plugins, wp-plugins, wp-themes, wp-uploads, wp-root
--targets	Wohin das Backup geht. Ohne den Schalter geht es an jedes benutzbare Ziel.	Kennungen benutzbarer Ziele, durch Komma getrennt
--no-snapshot	Liest die Datenbank ohne Momentaufnahme. Vorgabe ist die Momentaufnahme.	ohne Wert
--background	Der Befehl startet das Backup nur. Die Website treibt es selbst weiter.	ohne Wert
--max-per-step	Beendet jeden Schritt nach so vielen Einträgen oder Zeilen. Der Schalter dient der Diagnose.	ganze Zahl
--force	Läuft auch als anderer Benutzer.	ohne Wert

Eine Wurzel ist ein benannter Teil der Website: die Datenbank oder ein Ordner. Was in welcher Wurzel liegt, erklärt Einstellungen und Umfang mit WP-CLI.

# Alles an jedes benutzbare Ziel sichern
wp cloneworx-backup backup run

# Nur Datenbank und Uploads an ein Ziel sichern
wp cloneworx-backup backup run --roots=db,wp-uploads --targets=local-1

# Das Backup starten und der Website überlassen
wp cloneworx-backup backup run --background

Während das Backup läuft, schreibt der Befehl je Schritt eine Zeile: die Phase, die erledigten Einträge und Bytes und die restliche Zeit, sobald das Plugin sie kennt. Am Ende nennt er die Zahl der Schritte und der Warnungen. Darunter steht die Zusammenfassung: Wurzeln, Ziele, gespeicherte Größe, der Platz je Ort, die Datenbank, die Dateien, die Teile und je Ziel das Ergebnis der Übertragung.

Nach einem guten Backup treibt derselbe Prozess den Nachlauf: Das Plugin löscht veraltete Backups und räumt Reste abgebrochener Jobs an den Zielen auf.

Endet das Backup mit einem Fehler, nennt der Befehl die letzten Meldungen des Jobs, je Ziel den Stand und den Grund. Zu einem Fehler an einem Ziel steht darunter die Meldung des Servers im Wortlaut.

Mit --background kehrt der Befehl sofort zurück. Den Fortschritt zeigt dann wp cloneworx-backup job status.

Die Backups auflisten: list

backup list zeigt die Backups der Liste, das neueste zuerst. Ohne Aktion tut wp cloneworx-backup backup dasselbe.

Schalter	Bedeutung	Erlaubte Werte
--limit	Wie viele Backups die Ausgabe zeigt.	1 bis 100, Vorgabe 20

# Die letzten 20 Backups zeigen
wp cloneworx-backup backup list

# Nur die letzten 5 zeigen
wp cloneworx-backup backup list --limit=5

Jede Zeile nennt ein Backup: Job-Name, Status, Plan, Ende, Größe und je Ziel den Zustand des Backups dort. Am Ende der Zeile steht locked, wenn das Backup gesperrt ist. Die letzte Zeile sagt, wie viele Backups die Ausgabe zeigt und wie viele es gibt.

Status in der Ausgabe	Im Status-Filter der Seite Backup
running	Läuft
success	Vollständig
warnings	Mit Warnungen
error	Fehlgeschlagen
aborted	Abgebrochen

In der Spalte für den Plan steht die Kennung des Plans, zum Beispiel plan-1. manual steht für ein Backup ohne Plan, import für ein importiertes Backup und rediscovered für ein Backup, das an einem Ziel wiedergefunden wurde.

Ein Backup sperren und die Sperre aufheben: lock, unlock

backup lock sperrt ein Backup. Ein gesperrtes Backup wird nie automatisch gelöscht und bei Max. Sicherungen nicht mitgezählt. Von Hand löschen geht erst nach backup unlock. Beide Aktionen haben keine Schalter.

# Ein Backup sperren
wp cloneworx-backup backup lock <Job>

# Die Sperre aufheben
wp cloneworx-backup backup unlock <Job>

Der Befehl bestätigt die Sperre oder ihr Ende in einem Satz. Mehr zur Sperre: Ein Backup vor dem Löschen schützen.

Ein Backup prüfen: check

backup check liest ein Backup an jedem Ziel, an dem es vollständig liegt oder als beschädigt vermerkt ist: Eine neue Prüfung kann das Urteil ändern. Zurückgeschrieben wird dabei nichts. Das Plugin prüft, ob jede Datei mit ihrer Größe da ist, ob die Info-Datei gültig ist, ob jedes Teil zu seiner Prüfsumme passt und ob sich jeder Block lesen lässt. Einen lokalen Ordner liest es an Ort und Stelle. Von einem entfernten Ziel holt es ein Teil nach dem anderen in den Arbeitsordner.

Schalter	Bedeutung	Erlaubte Werte
--targets	Prüft nur an diesen Zielen. Ohne den Schalter: an jedem Ziel, an dem das Backup vollständig liegt oder als beschädigt vermerkt ist.	Kennungen, durch Komma getrennt
--background	Der Befehl startet die Prüfung nur. Die Website treibt den Job selbst weiter.	ohne Wert
--max-per-step	Beendet jeden Schritt nach so vielen Blöcken. Der Schalter dient der Diagnose.	ganze Zahl
--force	Läuft auch als anderer Benutzer.	ohne Wert

# Ein Backup an allen seinen Zielen prüfen
wp cloneworx-backup backup check <Job>

# Nur an einem Ziel prüfen
wp cloneworx-backup backup check <Job> --targets=local-1

Die Ausgabe hat je Ziel eine Zeile mit dem Ergebnis:

Ergebnis	Bedeutung
ok	Das Backup ist dort lesbar und vollständig. Die Zeile nennt Teile, Einträge und gelesene Bytes.
damaged or incomplete	Das Backup ist dort beschädigt oder unvollständig. Die Zeile nennt die Befunde.
not checked	Das Ziel hat nicht geantwortet. Das ist eine Warnung, kein Schaden.
not complete at this target	Das Backup liegt an diesem Ziel nicht vollständig.

Die letzte Zeile zählt zusammen. Fällt ein Ziel durch, gilt das Backup dort als beschädigt: Es wird bei Max. Sicherungen nicht mehr mitgezählt und nie automatisch gelöscht. Mehr dazu: Ein Backup prüfen.

Ein Backup als Datei schreiben: download

backup download schreibt ein Backup als eine tar-Datei auf den Server. Die Datei enthält einen Ordner mit dem Job-Namen, darin die Info-Datei, den Index und die Teile. Das Plugin liest am ersten lokalen Ziel, an dem das Backup vollständig liegt.

Schalter	Bedeutung	Erlaubte Werte
--to	Die Datei, die der Befehl schreibt. Pflicht. Die Datei darf es noch nicht geben, und ihr Ordner muss beschreibbar sein.	Pfad einer Datei

# Das Backup als tar-Datei schreiben
wp cloneworx-backup backup download <Job> --to=/tmp/backup.tar

Der Befehl nennt die Datei, ihre Größe, die Zahl der Dateien darin und das Ziel, an dem er gelesen hat. Liegt das Backup an keinem lokalen Ziel vollständig, endet er mit einem Fehler. Ein Backup, das nur an entfernten Zielen liegt, holst Du mit einem eigenen Programm von dort, zum Beispiel mit Deinem FTP-Programm. Mehr dazu: Ein Backup herunterladen.

Dieselbe Datei nimmt wp cloneworx-backup import wieder an; siehe Wiederherstellen und importieren mit WP-CLI.

Ein Backup löschen: delete

backup delete löscht ein Backup an jedem Ziel, an dem es liegt. Mit seiner letzten Kopie verschwindet das Backup aus der Liste. Vor dem Löschen fragt der Befehl nach.

Schalter	Bedeutung	Erlaubte Werte
--targets	Löscht nur an diesen Zielen. Die Kopien an den anderen Zielen bleiben. Solange es noch eine Kopie gibt, bleibt das Backup in der Liste.	Kennungen, durch Komma getrennt
--yes	Löscht ohne Rückfrage.	ohne Wert
--force	Läuft auch als anderer Benutzer.	ohne Wert

# Ein Backup überall löschen, mit Rückfrage
wp cloneworx-backup backup delete <Job>

# Nur die Kopie an einem Ziel löschen, ohne Rückfrage
wp cloneworx-backup backup delete <Job> --targets=local-1 --yes

• Ein gesperrtes Backup lehnt der Befehl ab. Hebe zuerst die Sperre auf.
• Ein laufendes Backup lehnt der Befehl ab. Brich es zuerst ab: wp cloneworx-backup job abort.
• Ein Eintrag ohne Kopie, zum Beispiel ein fehlgeschlagenes oder abgebrochenes Backup, verschwindet sofort aus der Liste, ohne Rückfrage und ohne Job.

Das Löschen läuft als Job in diesem Prozess. Am Ende nennt der Befehl, wie viele Backups gelöscht wurden und wie viele Versuche gescheitert sind. Mehr dazu: Ein Backup löschen.

Veraltete Backups zeigen und löschen: retention

Das Plugin behält je Backup-Plan und je Ziel so viele gute Backups, wie Max. Sicherungen im Plan sagt. Ältere fallen weg. Gesperrte Backups zählen nicht mit und fallen nie automatisch weg. Das neueste gute Backup fällt nie weg. Das geschieht von selbst nach jedem guten Backup. Mit wp cloneworx-backup retention siehst Du es vorher oder stößt es von Hand an.

Aktion	Zweck
retention list	Zeigt, welche Backups jetzt wegfielen. Löscht nichts. Ohne Aktion tut der Befehl dasselbe.
retention run	Löscht diese Backups jetzt und treibt den Job in diesem Prozess.

Schalter	Bedeutung	Erlaubte Werte
--plan	Nur diese Gruppe. Ohne den Schalter: jeder Plan und die Backups ohne Plan.	Kennung eines Plans, zum Beispiel plan-1, oder manual
--force	Nur run: läuft auch als anderer Benutzer.	ohne Wert

# Zeigen, was wegfiele
wp cloneworx-backup retention list

# Jetzt löschen, nur für einen Plan
wp cloneworx-backup retention run --plan=plan-1

# Jetzt löschen, nur Backups ohne Plan
wp cloneworx-backup retention run --plan=manual

retention list nennt je Zeile ein Backup, das Ziel und die Gruppe: den Namen des Plans oder manual. Die letzte Zeile zählt die Löschungen. Fällt nichts weg, sagt der Befehl das in einem Satz. retention run nennt am Ende, wie viele Backups gelöscht wurden.

Siehe auch

• Die Seite „Backup“
• Ein Backup sofort erstellen
• Festlegen, wie viele Backups aufbewahrt werden
• Backup-Pläne verwalten mit WP-CLI
• Zustand, Protokolle und Support mit WP-CLI