So richtest Du einen Bucket bei Amazon S3 als Ziel für Deine Backups ein: vom Zugriffsschlüssel mit den nötigen Rechten über den Verbindungstest bis zum gespeicherten Ziel.
Das brauchst Du
- einen Bucket bei Amazon S3, den es schon gibt: Das Plugin legt keinen an,
- einen Zugriffsschlüssel und den geheimen Schlüssel dazu,
- die Rechte für diesen Schlüssel, siehe den nächsten Abschnitt.
Für jeden anderen Dienst, der die S3-Schnittstelle anbietet, gibt es eine eigene Ziel-Art: Backups in einem S3-kompatiblen Speicher sichern.
Kein Dienst von cloneworx dazwischen
Du trägst Deinen Zugriffsschlüssel und den geheimen Schlüssel dazu ein. Das Plugin signiert jede Anfrage selbst. Der geheime Schlüssel verlässt den Webserver nie. Die Verbindung zu Amazon S3 ist immer verschlüsselt.
Die Rechte des Zugriffsschlüssels
Verwende einen Schlüssel, der nur für dieses Backup erstellt wurde und nur diesen Bucket erreichen darf. Für den Benutzer des Zugriffsschlüssels kann die Richtlinie bei Amazon so aussehen. Ersetze mein-backup-bucket durch den Namen Deines Buckets:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:ListBucketMultipartUploads"
],
"Resource": "arn:aws:s3:::mein-backup-bucket"
},
{
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:PutObject",
"s3:DeleteObject",
"s3:AbortMultipartUpload",
"s3:ListMultipartUploadParts"
],
"Resource": "arn:aws:s3:::mein-backup-bucket/*"
}
]
}
Fehlt eines der Rechte, nennt der Verbindungstest es. Ohne die beiden Rechte, die angefangene Uploads und ihre Teile auflisten (s3:ListBucketMultipartUploads und s3:ListMultipartUploadParts), funktionieren Backups trotzdem; der Verbindungstest warnt dann.
Schritt 1: Ziel-Art wählen
Öffne die Seite Ziele und klicke auf Ziel hinzufügen. Wähle Amazon S3.
- Die Ziel-Arten, die es gibt. Amazon S3 hat das Zeichen „aws“.
- Schließen schließt die Auswahl.
Das Plugin verbindet sich mit Amazon S3 über die PHP-Erweiterung cURL und liest die Antworten mit der PHP-Erweiterung DOM. Fehlt dem Webserver etwas davon, ist Amazon S3 ausgegraut und hat das Label Auf diesem Server nicht verfügbar. Der Grund steht unter der Auswahl.
Schritt 2: Formular ausfüllen
- Name ist frei wählbar. Das Plugin schlägt „Amazon S3 1“ vor; jeder Name ist möglich, der noch nicht vergeben ist.
- Bucket ist der Name des Buckets, in dem die Backups liegen sollen.
- Zugriffsschlüssel steht sichtbar im Formular, wie ein Benutzername.
- Geheimer Schlüssel wird verschlüsselt gespeichert und wird nie an den Browser zurückgegeben.
- Ordner im Bucket darf leer bleiben: Dann liegt der Ordner dieser Website direkt im Bucket.
- Verbindung testen prüft die eingegebenen Werte, ohne zu speichern.
Felder mit rotem Stern sind Pflichtfelder.
Der Bucket darf nicht öffentlich sein
Stelle sicher, dass der Bucket nicht öffentlich ist: Ohne die Schlüssel darf ihn niemand erreichen. Das Plugin schickt nie Anfragen zur Probe von außen. Es kann Dir deshalb nicht sagen, ob der Bucket öffentlich ist.
Schritt 3: Verbindung testen
Klicke auf Verbindung testen. Der Test schreibt eine kleine Datei in den Bucket, liest sie zurück, listet sie auf und löscht sie wieder. Dazu lädt er eine Testdatei von gut 5 MiB in zwei Teilen hoch und misst dabei die Upload-Rate. Auch diese Datei löscht er wieder.
- Das Ergebnis des Tests: Die Verbindung funktioniert, eine Testdatei wurde geschrieben, zurückgelesen und gelöscht.
- Eine Warnung des Tests. Im Bild bewahrt der Bucket Versionen auf.
- Die Region des Buckets, das Upload-Verfahren und die gemessene Upload-Rate.
Ist der Test gelungen, stehen im Formular diese Zeilen:
| Zeile im Ergebnis | Bedeutung |
|---|---|
| Verbindung funktioniert: Eine Testdatei wurde geschrieben, zurückgelesen und gelöscht. | Schreiben, Zurücklesen, Auflisten und Löschen funktionieren. |
| Region des Buckets: … | Die Region, die Amazon S3 für den Bucket nennt. Das Plugin speichert sie beim Ziel. |
| Upload-Verfahren: in Teilen (Multipart-Upload); ein Upload geht mit dem nächsten Teil weiter. | S3 kann den Upload einer Datei nicht fortsetzen. Das Plugin lädt jede Datei deshalb in Teilen hoch. |
| Gemessene Upload-Rate: … je Sekunde. | Nach der Rate wählt das Plugin die Größe der Teile. |
Unter der ersten Zeile stehen Warnungen in gelb, wenn der Test etwas bemerkt hat. Der Abschnitt „Warnungen nach einem gelungenen Test“ erklärt sie.
Schritt 4: Speichern
Klicke auf Speichern. Das Plugin speichert das Ziel, testet die Verbindung noch einmal und meldet das Ergebnis: „…“ gespeichert und verbunden. Pläne und Backups nutzen ein Ziel erst nach einem gelungenen Verbindungstest.
- Alle Ziele sind verbunden.
- Die Meldung nennt das Ziel: gespeichert und verbunden.
- Das neue Ziel steht in der Liste. Der grüne Punkt bedeutet: verbunden. Vor einem Ziel der Art Amazon S3 steht das Zeichen „aws“.
Nach dem Speichern und dem gelungenen Verbindungstest sieht das Plugin am Ort des Ziels nach. Findet es dort den Ordner einer anderen Installation, erscheint die Kachel Backups gefunden an „…“. Backups im Ordner dieser Installation, die in der Liste der Backups an diesem Ziel fehlen, nimmt es von selbst in die Liste auf, oder dieselbe Kachel bietet an, sie aufzunehmen. Mehr dazu: Backups nach einer Neuinstallation wiederfinden.
Schritt 5: Das Ziel im Backup-Plan wählen
- Dein erstes Ziel: Das Plugin legt den Plan „Tägliches Backup“ an: täglich zu einer zufälligen Uhrzeit, alles, dieses Ziel, Max. Sicherungen 7. Der Plan ist pausiert, bis Du ihn einschaltest.
- Ein weiteres Ziel: Wähle es auf der Seite Backup in der Kachel Backup-Pläne in einem Plan. Die freie Version erlaubt ein Ziel je Plan.
Mehr dazu: Backups automatisch planen.
Die Felder der Ansicht Erweitert
-
Region darf leer bleiben: Dann fragt der Verbindungstest Amazon S3 nach der Region des Buckets. Ein Beispiel für eine Region ist
eu-central-1. - Zeitgrenze für den Verbindungsaufbau (Sekunden) akzeptiert 3 bis 60, der Standardwert ist 10.
- Upload-Rate (Bytes je Sekunde) darf leer bleiben: Dann gilt, was der Verbindungstest gemessen hat.
In einem leeren Feld, dessen Wert der Test feststellt, steht automatisch. Jeder Verbindungstest stellt Region und Rate neu fest. Eine Upload-Rate, die Du selbst einträgst, hat Vorrang. Nennt Amazon S3 eine andere Region als die, die Du eingetragen hast, arbeitet das Plugin mit der Region des Dienstes, und der Verbindungstest warnt.
Warnungen nach einem gelungenen Test
| Warnung | Was Du tun kannst |
|---|---|
| Der Dienst nennt eine andere Region als die, die Du eingetragen hast. Das Plugin benutzt die Region des Dienstes; berichtige das Feld Region. | Trage in der Ansicht Erweitert die Region ein, die das Ergebnis nennt, oder leere das Feld Region. |
| Dieser Bucket bewahrt Versionen auf: Ein gelöschtes Backup bleibt dort als alte Version liegen und belegt weiter Platz. Richte beim Dienst eine Lifecycle-Regel ein, die alte Versionen entfernt. | Richte die Regel bei Amazon S3 ein. Das Löschen durch das Plugin versteckt ein Backup in einem solchen Bucket nur. |
| Der Dienst listet angefangene Uploads nicht auf, deshalb kann das Plugin sie dort nicht aufräumen. Richte beim Dienst eine Lifecycle-Regel ein, die angefangene Uploads entfernt. | Gib dem Schlüssel das Recht s3:ListBucketMultipartUploads, oder richte die Regel ein. |
| Der Dienst lässt das Plugin die Teile eines Uploads nicht auflisten. Uploads gehen, aber das Plugin kann sie nicht prüfen, bevor es weitermacht. | Gib dem Schlüssel das Recht s3:ListMultipartUploadParts. |
| Die Uhr dieses Webservers weicht um etwa … Minuten von der Uhr des Dienstes ab. Das Plugin arbeitet mit der Zeit des Dienstes; lass die Uhr des Webservers berichtigen. | Bitte Deinen Hoster, die Uhr des Webservers zu berichtigen. Backups laufen bis dahin weiter. |
Wenn der Test scheitert
Scheitert der Test, steht das Ergebnis unter den Feldern des Formulars. Im Bild fehlt dem Zugriffsschlüssel das Recht, Objekte zu schreiben.
- Die Ursache im Klartext. Der Link am Ende, Globales Protokoll anzeigen, öffnet das globale Protokoll. Dort stehen die Einzelheiten des Tests.
- Das Recht, das dem Zugriffsschlüssel fehlt.
- Meldung des Ziels ist die Fehlermeldung des Dienstes im Original.
Die Zeile 2 steht nur unter manchen Ursachen und nennt den Grund genauer, zum Beispiel das fehlende Recht. Hat auch cURL etwas gemeldet, steht unter Meldung des Ziels die Zeile Meldung des Clients. Die Fehlermeldungen in diesen beiden Zeilen sind nicht übersetzt. Der Bucket, der Zugriffsschlüssel und der Servername des Dienstes sind darin unkenntlich gemacht; der geheime Schlüssel wird nie gesendet.
| Meldung | Was Du tun kannst |
|---|---|
| Das Ziel ist nicht erreichbar. Prüfe den Servernamen und den Port; der Hoster dieser Website sperrt den Port vielleicht. | Den Servernamen des Dienstes bildet das Plugin aus der Region. Prüfe in der Ansicht Erweitert das Feld Region, oder leere es. Stimmt die Region, frage Deinen Hoster, ob der Webserver Verbindungen nach außen aufbauen darf. |
| Der Dienst hat die Schlüssel abgelehnt. | Darunter steht, welcher Schlüssel nicht stimmt: Der Dienst kennt diesen Zugriffsschlüssel nicht. Oder: Die Signatur der Anfrage wurde abgelehnt: Der geheime Schlüssel gehört nicht zu diesem Zugriffsschlüssel. Gib den Schlüssel neu ein. |
| Dem Zugriffsschlüssel fehlt ein Recht, das das Plugin braucht. | Darunter steht das Recht: Fehlendes Recht: …. Ergänze es in der Richtlinie des Schlüssels. |
| Den Bucket gibt es bei diesem Dienst nicht. Das Plugin legt keine Buckets an. | Prüfe den Namen im Feld Bucket, oder lege den Bucket bei Amazon S3 an. |
| Der Bucket liegt in einer anderen Region als der, die benutzt wurde. | Darunter steht die Region des Buckets. Trage sie im Feld Region ein, oder leere das Feld. |
| Der Dienst lehnt die Anfrage ab, weil die Uhr dieses Webservers weiter abweicht, als der Dienst erlaubt. | Bitte Deinen Hoster, die Uhr des Webservers zu berichtigen. |
| Ein Upload kam nicht an, bevor die Zeit eines Schritts abgelaufen war: Die Verbindung zum Ziel ist dafür zu langsam. | Darunter steht der Grund: Dieser Dienst nimmt einen Upload nur in Teilen von mindestens 5 MiB an, und ein solches Teil muss in einem Schritt ankommen. Wie lange ein Schritt höchstens dauert, bestimmt die Einstellung Höchstdauer je Schritt: Das Plugin an Deinen Server anpassen. |
| Dieser Wert ist nicht gültig. am Feld Bucket | Der Name eines Buckets bei Amazon S3 hat 3 bis 63 Zeichen: Kleinbuchstaben, Ziffern, Punkte und Bindestriche. Er beginnt und endet mit einem Buchstaben oder einer Ziffer. Zwei Punkte hintereinander und die Form einer IP-Adresse akzeptiert das Formular nicht. |
Angefangene Uploads und Versionen
- Angefangene Uploads. Ein Upload, der nie abgeschlossen wurde, belegt beim Dienst weiter Platz. Bei Amazon S3 verfällt er nie von selbst. Das Plugin bricht seine eigenen angefangenen Uploads ab, und das Aufräumen der Reste bricht die ab, die es findet. Richte trotzdem bei Amazon S3 eine Lifecycle-Regel ein, die angefangene Uploads nach einigen Tagen entfernt.
- Versionen. Bewahrt der Bucket Versionen auf, versteckt das Löschen ein Backup nur: Die alten Versionen bleiben und belegen weiter Platz. Richte eine Lifecycle-Regel ein, die alte Versionen entfernt.
Gut zu wissen
- Die Backups liegen im Bucket unter
<Ordner>/cloneworx-backup-<Code>/<Backup>/. - Ein Teil eines Uploads ist mindestens 5 MiB groß, nur das letzte darf kleiner sein. Eine Datei erscheint im Bucket erst, wenn ihr Upload abgeschlossen ist.
- In einen Bucket legt das Plugin keine Schutzdateien: Ein Bucket wird nicht von einem Webserver ausgeliefert, der sie läse.
- Das Plugin folgt nie einer Weiterleitung.
- Backups, die nur in einem Bucket liegen, lädst Du nicht über das Plugin herunter, sondern mit einem Programm für S3 oder in der Weboberfläche des Dienstes. Restore, Prüfung und Wiederfinden lesen direkt vom Dienst.
- Das Plugin benutzt einen Proxy aus der
wp-config.phpauch für Amazon S3. Die Konstanten heißenWP_PROXY_HOST,WP_PROXY_PORT,WP_PROXY_USERNAME,WP_PROXY_PASSWORDundWP_PROXY_BYPASS_HOSTS. - Unter der Auswahl der Ziel-Arten steht der Hinweis: Namen & Logos von Drittanbietern befinden sich im Besitz ihrer jeweiligen Eigentümer. Dies impliziert keine Zugehörigkeit oder Partnerschaft.
Siehe auch
- Welches Ziel passt zu Dir?
- Backups in einem S3-kompatiblen Speicher sichern
- Die Seite „Ziele“
- Zugangsdaten eines Ziels erneuern
- Backups an einem Ziel prüfen und Reste aufräumen
Auf der Kommandozeile
WP-CLI noch nicht eingerichtet? So installierst Du WP-CLI.
Die Kommandozeile akzeptiert den geheimen Schlüssel nicht; ein Ziel der Art Amazon S3 richtest Du deshalb auf der Seite Ziele ein. Alles Weitere funktioniert auch mit WP-CLI:
# Ziele mit Kennung und Zustand zeigen wp cloneworx-backup target list # Die Verbindung testen wp cloneworx-backup target test amazon-s3-1 # Einen Plan anlegen, der an dieses Ziel sichert wp cloneworx-backup plan add --target=amazon-s3-1 --rhythm=daily --time=03:15 --name="Nachts" # Die Backups an diesem Ziel prüfen wp cloneworx-backup target check amazon-s3-1 # Reste und angefangene Uploads zeigen (--dry-run) und aufräumen wp cloneworx-backup target cleanup amazon-s3-1 --dry-run wp cloneworx-backup target cleanup amazon-s3-1