Doku/Backup Docker - Versionsgeschichte

Hendrik: /* 2 Script herunterladen */

2025-06-06T16:21:19Z

2 Script herunterladen

@@ Zeile 19: / Zeile 19: @@
 </syntaxhighlight>
-== 2 Script herunterladen ==
+== 2 Backupscript ==
 <syntaxhighlight lang="bash">
-curl -o /usr/local/sbin/backup_docker_rsync.sh \
+#!/usr/bin/env bash
-      https://<dein-git>/backup_docker_rsync.sh
+# ==========================================================================
-chmod +x /usr/local/sbin/backup_docker_rsync.sh
+#  backup_docker_rsync.sh  –  Docker-Volumes & Compose sichern (rsync)
 </syntaxhighlight>

Hendrik: /* 7 Wiederherstellung */

2025-06-06T16:19:59Z

7 Wiederherstellung

← Nächstältere Version		Version vom 6. Juni 2025, 18:19 Uhr
Zeile 80:		Zeile 80:

	== 7 Wiederherstellung ==		== 7 Wiederherstellung ==
	Siehe [[~~Doku/Restore_Docker~~]]		Siehe [[Docker]]
	Kurzfassung für „latest“:		Kurzfassung für „latest“:
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">

Hendrik: Die Seite wurde neu angelegt: „= Docker-Backups im Homelab = Diese Seite beschreibt die komplette Einrichtung und Funktionsweise des Scripts `backup_docker_rsync.sh`, mit dem alle Docker-Volumes, Compose-Dateien und die Docker-Daemon-Konfiguration täglich auf das QNAP-NAS gesichert werden. ; Repository `/usr/local/sbin/backup_docker_rsync.sh` (lokal) ; Zielpfad NAS `/mnt/Backup/Docker/YYYY-MM-DD-HHMM` ⇒ Symlink '''latest''' == 1 Voraussetzu…“

2025-06-06T16:19:12Z

Die Seite wurde neu angelegt: „= Docker-Backups im Homelab = Diese Seite beschreibt die komplette Einrichtung und Funktionsweise des Scripts <code>backup_docker_rsync.sh</code>, mit dem alle Docker-Volumes, Compose-Dateien und die Docker-Daemon-Konfiguration täglich auf das QNAP-NAS gesichert werden. ; Repository <code>/usr/local/sbin/backup_docker_rsync.sh</code> (lokal) ; Zielpfad NAS <code>/mnt/Backup/Docker/YYYY-MM-DD-HHMM</code> ⇒ Symlink '''latest''' == 1 Voraussetzu…“

Neue Seite

= Docker-Backups im Homelab =
Diese Seite beschreibt die komplette Einrichtung und Funktionsweise des Scripts
<code>backup_docker_rsync.sh</code>, mit dem alle Docker-Volumes, Compose-Dateien
und die Docker-Daemon-Konfiguration täglich auf das QNAP-NAS gesichert werden.

; Repository
<code>/usr/local/sbin/backup_docker_rsync.sh</code> (lokal)
; Zielpfad NAS
<code>/mnt/Backup/Docker/YYYY-MM-DD-HHMM</code> ⇒ Symlink '''latest'''

== 1 Voraussetzungen ==
* **Ubuntu 22.04 LTS** (Root-Zugriff)
* NAS-Share unter <code>/mnt/Backup</code> gemountet
**Empfohlen**: NFS (+ <code>no_root_squash</code>).
SMB/CIFS funktioniert mit den rsync-Optionen <code>--no-owner --no-group</code>.
* Pakete:
<syntaxhighlight lang="bash">
apt install rsync jq
</syntaxhighlight>

== 2 Script herunterladen ==
<syntaxhighlight lang="bash">
curl -o /usr/local/sbin/backup_docker_rsync.sh \
https://<dein-git>/backup_docker_rsync.sh
chmod +x /usr/local/sbin/backup_docker_rsync.sh
</syntaxhighlight>

=== 2.1 Wichtige Variablen im Kopfbereich ===
{| class="wikitable"
! Variable !! Standardwert !! Bedeutung
|-
| <code>SNAPROOT</code> || <code>/mnt/Backup/Docker</code> || Ablageort der Snapshots
|-
| <code>RETENTION_DAYS</code> || <code>7</code> || Aufbewahrung (ältere Snapshots werden gelöscht)
|-
| <code>COMPOSE_BASE</code> || <code>/data/compose</code> || Oberordner der Compose-Stacks
|}

== 3 Cron Job (täglich 02:30 Uhr) ==
<syntaxhighlight lang="cron">
# crontab -e (als root)
30 2 * * * /usr/local/sbin/backup_docker_rsync.sh \
>> /var/log/backup_docker.log 2>&1
</syntaxhighlight>

* '''Logging''': Alle Ausgaben in <code>/var/log/backup_docker.log</code>.
* Bei Fehlercodes ≠0 wird der Cron-MTA eine Mail an root schicken (sofern konfiguriert).

== 4 Funktionsweise ==
# **Metadaten-Dump** (Docker info, Container-/Image-Listen, Compose-YAMLs).
# **Nur noch laufende Container** werden kurz mit <code>docker pause</code> eingefroren.
# **rsync Snapshot**
* Hard-Links via <code>--link-dest</code> → jede Sicherung „Vollkopie“, aber nur Deltas belegen Platz.
* Ohne <code>-o -g</code> ⇒ kompatibel mit SMB/NFS-Shares.
# **Unpause** der zuvor laufenden Container (Cleanup-Trap gewährleistet dies selbst bei Abbruch).
# **latest-Symlink** wird aktualisiert, alte Snapshots nach <code>RETENTION_DAYS</code> gelöscht.
# **Rechte 755/644** auf neuem Snapshot → Windows-Benutzer können per SMB browsen.

== 5 Snapshot-Struktur ==
<pre>
/mnt/Backup/Docker/
└── 2025-06-06-0230/
├── volumes/ # kompletter Inhalt von /var/lib/docker/volumes
├── etc-docker/ # /etc/docker
├── docker-systemd/ # systemd-Drop-Ins (falls vorhanden)
└── metadata/
├── docker-info.txt
├── images.txt
├── containers.txt
└── compose/… # alle docker-compose*.yml
latest -> 2025-06-06-0230
</pre>

== 6 Manueller Testlauf ==
<syntaxhighlight lang="bash">
/usr/local/sbin/backup_docker_rsync.sh
echo $?
# → 0 = Erfolg
</syntaxhighlight>

== 7 Wiederherstellung ==
*Siehe [[Doku/Restore_Docker]]*
Kurzfassung für „latest“:
<syntaxhighlight lang="bash">
restore_docker_rsync.sh -s latest
</syntaxhighlight>

== 8 Troubleshooting ==
{| class="wikitable"
! Meldung !! Ursache / Lösung
|-
| <code>--link-dest arg does not exist</code> || Erster Lauf → ignorieren.
|-
| <code>Operation not permitted (chown)</code> || SMB-Share ohne Chown-Rechte → OK; Daten wurden trotzdem kopiert.
|-
| Container bleiben <code>paused</code> || Script vor v1.1; aktualisieren ODER manuell
<code>docker unpause $(docker ps -q --filter status=paused)</code>
|-
| Windows kann nicht lesen || Fs-Rechte → Script ≥v1.2 setzt 755/644
oder Share mit <code>noperm</code> mounten.
|}

== 9 Versionshistorie ==
{| class="wikitable"
! Datum !! Version !! Änderung
|-
| 2025-06-06 || 1.2 || Rechtefix (755/644), robustes Unpause, Link-Dest-Check
|-
| 2025-06-05 || 1.1 || Pausiere nur laufende Container, Cleanup-Trap
|-
| 2025-06-04 || 1.0 || Erste produktive Version
|}

----
''Seite zuletzt aktualisiert: 06 Juni 2025''