So verschieben Sie Containerdaten auf einen SSD-Pool, ohne Mount-Pfade zu beschädigen

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Verschieben Sie die Host-Datenquelle auf die SSD, während jeder containerseitige Zielpfad unverändert bleibt.

Bei einer sicheren Migration gilt die aktuelle Mount-Zuordnung als Schnittstellenvertrag. Container, Datenbanken und Medienanwendungen erwarten Pfade wie /config, /data oder /media, unabhängig davon, welche Festplatte sie bereitstellt. Der Ablauf muss Schreibvorgänge stoppen, die SSD zuverlässig einbinden, Eigentümerschaft und Metadaten kopieren, nur den Host-Quellpfad aktualisieren, die neue Einbindung vor dem Start überprüfen und die ursprünglichen Daten so lange aufbewahren, bis ein vollständiger Wiederherstellungstest bestanden ist.

Alle aktuellen Quell- und Container-Zielpfade erfassen

Exportieren Sie die Compose-Datei oder die Container-Inspektionsdaten und listen Sie alle Bind-Mounts, benannten Volumes, tmpfs-Mounts, Datenbankverzeichnisse, Caches, Transcodierungspfade und Medienpfade auf. Notieren Sie Host-Quellpfad und Container-Zielpfad getrennt.

Ein praktischer Leitfaden zur Volume-Migration beginnt damit, die aktuellen Daten zu lokalisieren und die Container anzuhalten, bevor die Daten an einen neuen Speicherort auf der Festplatte kopiert werden. Diese Bestandsaufnahme verhindert, dass Konfigurationsdaten auf der Systemfestplatte zurückbleiben.

Kennzeichnen Sie, welche Pfade maßgebliche Zustandsdaten, wiederherstellbaren Cache und große Mediendateien enthalten. Gehen Sie nicht davon aus, dass ein Ordner namens data alle dauerhaften Anwendungsdaten enthält.

Den SSD-Pool zuverlässig vor dem Start von Docker einbinden

Erstellen Sie das Dateisystem oder den Pool auf der SSD, identifizieren Sie ihn anhand einer stabilen UUID oder eines Poolnamens und binden Sie ihn unter dem endgültigen Hostpfad ein. Prüfen Sie nach einem Neustart den freien Speicherplatz, die erwarteten Dateisystemfunktionen und den Schreibzugriff.

Das Verschieben von Docker-Daten auf externen Speicher kann fehlschlagen, wenn die Festplatte beim Start fehlt oder unter einem anderen Pfad eingebunden ist. Ein aktueller Fall mit einer externen SSD zeigt, wie die Verlagerung des Docker-Speichers die Abhängigkeit von dem Ziel-Einhängepfad verändert.

Konfigurieren Sie die Dienstreihenfolge oder das Automount-Verhalten so, dass Docker niemals ein leeres Ausweichverzeichnis auf der Systemfestplatte erstellt. Brechen Sie ab, wenn die SSD nicht unter dem genau erwarteten Pfad eingebunden ist.

Schreibvorgänge stoppen und Daten mit erhaltenen Metadaten kopieren

Stoppen Sie die Anwendung und alle Abhängigkeiten, die in ihre Daten schreiben können, einschließlich Datenbanken, Indexer, Downloader und Hintergrundaufgaben. Erstellen Sie bei Datenbanken vor dem Kopieren von Rohdateien einen anwendungskonsistenten Dump oder fahren Sie sie sauber herunter.

Eine Diskussion über Synology-Container empfiehlt, ein von Docker verwaltetes Volume erst dann in einen Bind-Mount zu verschieben, wenn die Volumedaten identifiziert wurden und ihr Inhalt unter der neuen Bind-Mount-Quelle erhalten bleibt.

Rekursiv kopieren und dabei Eigentümerangaben, Berechtigungen, Zeitstempel, Links, ACLs und erweiterte Attribute erhalten, sofern unterstützt. Nach dem Kopieren und vor der Änderung von Compose einen Vergleichslauf oder eine Stichprobenprüfung per Prüfsumme durchführen.

Single board computer zimaboard2

Nur den Quellpfad auf dem Host ändern

Das Container-Ziel unverändert lassen. Zum Beispiel /oldpool/app:/config in /ssdpool/app:/config ändern, statt der Anwendung einen neuen internen Pfad beizubringen.

Bind-Mounts stellen einen bestimmten Host-Pfad unter einem stabilen Pfad im Container bereit. Eine Speicherübersicht erläutert, dass diese direkte Zuordnung nützlich ist, wenn Administratoren den Host-Pfad kontrollieren müssen.

Wenn das Ziel unverändert bleibt, werden Anwendungsdatenbanken, Bibliotheksverweise, Skripte, Berechtigungen und Konfigurationswerte, die den containerinternen Pfad speichern, nicht beschädigt.

Eigentümerangaben, Labels und Datenbankkonsistenz wiederherstellen

Die vom Image erwarteten numerischen UID- und GID-Werte mit den Eigentümerangaben auf der SSD vergleichen. Außerdem ACLs, SELinux-Labels, AppArmor-Berechtigungen und Mount-Optionen wiederherstellen, die für Sperren oder speicherabgebildete Dateien erforderlich sind.

Ein Leitfaden zur Migration des Docker-Speichers unter macOS weist darauf hin, dass das Verlegen der Docker-Daten das Kopieren des vollständigen Speicherabbilds und anschließend die Bestätigung erfordert, dass die Laufzeit den neuen Speicherort verwendet. Auf Linux-NAS-Systemen muss entsprechend geprüft werden, ob jede konfigurierte Quelle auf die eingebundene SSD verweist.

Nur die Datenbank starten und die Wiederherstellungsprotokolle prüfen, bevor abhängige Apps gestartet werden. Meldet sie Beschädigungen oder fehlende Dateien, den Vorgang stoppen und zur ursprünglichen Kopie zurückkehren, statt den Anwendungen zu erlauben, eine leere Datenbank zu initialisieren.

Mit Rollback-Option umstellen und den vollständigen Workflow testen

Den Stack in Abhängigkeitsreihenfolge starten und Konfiguration, Datenbankeinträge, Berechtigungen, Medienbibliotheken, Uploads, Downloads, Aktualisierungen und die Neuerstellung des Containers überprüfen. Prüfen, ob neue Schreibvorgänge auf der SSD landen und der Systemdatenträger nicht weiter anwächst.

Der ZimaSpace-Artikel über einen schreibgeschützt gewordenen Docker-Bind-Mount behandelt den nächsten Diagnoseschritt, wenn der migrierte Pfad zwar eingebunden wird, Schreibvorgänge aber abweist.

Die alten Daten offline und unverändert lassen, bis Sicherungen erstellt wurden und ein zweiter Container erfolgreich vom SSD-Pfad aus neu aufgebaut wurde. Die alte Quelle erst entfernen, nachdem ein Rollback-Test gezeigt hat, dass sich die Compose-Datei, Mounts, Datenbanken und der Anwendungsstatus wiederherstellen lassen.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.