chore: import v0.3.0 baseline and add v0.4 recovery architecture plan

This commit is contained in:
Lars committed 2026-10-29 13:58:35 +01:00
commit 40188c0e10
12 files changed
+1506

No files matched your search

+257
View File
@@ -0,0 +1,257 @@
#!/usr/bin/env bash
# ============================================================
# backupPaperlessData.sh
# Versionierte NAS-Sicherung mit rsync
# ============================================================
set -Eeuo pipefail
umask 027
# ============================================================
# KONFIGURATION
# ============================================================
SOURCE="/media/lars/paperless"
NAS_MOUNT="/backup"
NAS_SOURCE="192.168.2.63:/volume1/Backup_Paperless"
TARGET="/backup/data_archiv"
LOG="/home/lars/backupPaperlessData.sh.log"
# Monatliche Rotation: 01 bis 31
TODAY="$(date +%d)"
DEST="$TARGET/$TODAY"
LAST="$TARGET/last"
STAGING=""
OLD_DEST=""
TEMP_LINK=""
# ============================================================
# LOGGING
# ============================================================
exec > >(tee -a "$LOG") 2>&1
log() {
echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*"
}
# ============================================================
# FEHLERBEHANDLUNG
# ============================================================
on_exit() {
local rc=$?
trap - EXIT
if (( rc != 0 )); then
log "FEHLER: Backup abgebrochen (Exit-Code $rc)"
fi
# Unvollstaendige temporaere Sicherung entfernen.
# Bestehende Tages-Snapshots bleiben erhalten.
if [[ -n "$STAGING" && -d "$STAGING" ]]; then
rm -rf -- "$STAGING" || true
fi
if [[ -n "$TEMP_LINK" && -L "$TEMP_LINK" ]]; then
rm -f -- "$TEMP_LINK" || true
fi
}
trap on_exit EXIT
trap 'exit 130' INT
trap 'exit 143' TERM
fail() {
log "FEHLER: $*"
exit 1
}
# ============================================================
# START
# ============================================================
log "========================================"
log "NAS-Datenbackup gestartet"
log "Quelle: $SOURCE"
log "Ziel: $DEST"
# ============================================================
# PARALLELE BACKUPS VERHINDERN
# ============================================================
exec 9< "$0"
if ! flock -n 9; then
fail "Ein weiterer Backup-Prozess laeuft bereits"
fi
# ============================================================
# NAS-MOUNT PRUEFEN
# ============================================================
if ! findmnt \
--mountpoint "$NAS_MOUNT" \
--types nfs4 \
--source "$NAS_SOURCE" \
>/dev/null; then
fail "Synology-NFS-Freigabe nicht eingebunden: $NAS_MOUNT"
fi
log "NAS-Mount erfolgreich geprueft"
# ============================================================
# QUELLE UND ZIEL PRUEFEN
# ============================================================
[[ -d "$SOURCE" ]] ||
fail "Quellverzeichnis fehlt: $SOURCE"
[[ -n "$(find "$SOURCE" -mindepth 1 -maxdepth 1 -print -quit)" ]] ||
fail "Quellverzeichnis ist leer: $SOURCE"
[[ -d "$TARGET" ]] ||
fail "Backup-Zielverzeichnis fehlt: $TARGET"
[[ -w "$TARGET" ]] ||
fail "Backup-Zielverzeichnis nicht beschreibbar: $TARGET"
# ============================================================
# HARDLINK-REFERENZ
# ============================================================
RSYNC_OPTIONS=(
-a
-v
-R
--delete
--stats
)
if [[ -L "$LAST" && ! -d "$LAST" ]]; then
fail "Der last-Verweis ist ungueltig"
fi
if [[ -d "$LAST" ]]; then
RSYNC_OPTIONS+=("--link-dest=$LAST")
log "Hardlink-Referenz: $(readlink -f "$LAST")"
else
log "Keine vorherige Hardlink-Referenz gefunden"
fi
# ============================================================
# TEMPORAEREN SNAPSHOT ANLEGEN
# ============================================================
STAGING="$(mktemp -d "$TARGET/.inprogress-${TODAY}.XXXXXXXX")"
log "Temporaerer Snapshot: $STAGING"
# ============================================================
# RSYNC AUSFUEHREN
# ============================================================
log "rsync gestartet"
if rsync "${RSYNC_OPTIONS[@]}" \
"$SOURCE" "$STAGING"; then
log "rsync erfolgreich abgeschlossen"
else
RC=$?
fail "rsync fehlgeschlagen (Exit-Code $RC)"
fi
# ============================================================
# SICHERUNGSERGEBNIS PRUEFEN
# ============================================================
EXPECTED="$STAGING/media/lars/paperless"
[[ -d "$EXPECTED" ]] ||
fail "Erwartete Sicherungsstruktur fehlt: $EXPECTED"
# ============================================================
# SNAPSHOT AKTIVIEREN
# ============================================================
# Einen vorhandenen Tages-Snapshot erst verschieben,
# nachdem die neue Sicherung vollstaendig ist.
if [[ -e "$DEST" ]]; then
[[ -d "$DEST" && ! -L "$DEST" ]] ||
fail "Tagesziel ist kein normales Verzeichnis: $DEST"
OLD_DEST="$(mktemp -d "$TARGET/.replaced-${TODAY}.XXXXXXXX")"
rmdir -- "$OLD_DEST"
mv -T -- "$DEST" "$OLD_DEST" ||
fail "Alter Tages-Snapshot konnte nicht verschoben werden"
fi
# Neue Sicherung an die Stelle des Tages-Snapshots setzen.
if ! mv -T -- "$STAGING" "$DEST"; then
# Bei einem Fehler den alten Tagesstand zurueckholen.
if [[ -n "$OLD_DEST" && -d "$OLD_DEST" ]]; then
mv -T -- "$OLD_DEST" "$DEST" || true
fi
fail "Neuer Tages-Snapshot konnte nicht aktiviert werden"
fi
STAGING=""
# ============================================================
# LAST-VERWEIS AKTUALISIEREN
# ============================================================
TEMP_LINK="$TARGET/.last-new-$$"
ln -s -- "$DEST" "$TEMP_LINK" ||
fail "Neuer last-Verweis konnte nicht erstellt werden"
mv -Tf -- "$TEMP_LINK" "$LAST" ||
fail "last-Verweis konnte nicht aktualisiert werden"
TEMP_LINK=""
log "last zeigt jetzt auf: $DEST"
# ============================================================
# ALTEN TAGES-SNAPSHOT ENTFERNEN
# ============================================================
# Nur die durch diesen Lauf ersetzte Tagesversion loeschen.
# Andere Sicherungsstaende bleiben unveraendert.
if [[ -n "$OLD_DEST" && -d "$OLD_DEST" ]]; then
if rm -rf -- "$OLD_DEST"; then
log "Ersetzter Tages-Snapshot entfernt"
else
log "WARNUNG: Alter Tages-Snapshot konnte nicht vollstaendig entfernt werden"
fi
fi
log "NAS-Datenbackup erfolgreich abgeschlossen"
log "========================================"
exit 0
+91
View File
@@ -0,0 +1,91 @@
#!/usr/bin/env bash
set -Eeuo pipefail
umask 077
# Verwendung:
# db-mariadb-docker.sh CONTAINER DATEINAME mariadb|mysql
if [[ $# -ne 3 ]]; then
echo "FEHLER: Drei Parameter erforderlich" >&2
exit 2
fi
CONTAINER="$1"
FILENAME="$2"
PROFILE="$3"
BACKUP_DIR="/media/lars/paperless/db-backup"
[[ "$FILENAME" =~ ^[a-zA-Z0-9_-]+\.sql$ ]] || exit 2
[[ -d "$BACKUP_DIR" && -w "$BACKUP_DIR" ]] || {
echo "FEHLER: Backup-Verzeichnis nicht verfuegbar" >&2
exit 1
}
TARGET="$BACKUP_DIR/$FILENAME"
TEMP="$(mktemp "$BACKUP_DIR/.${FILENAME}.XXXXXXXX")"
trap 'rm -f -- "$TEMP"' EXIT
echo "Starte MariaDB-Export: $CONTAINER"
case "$PROFILE" in
mariadb)
docker exec "$CONTAINER" sh -ec '
: "${MARIADB_USER:?Benutzer fehlt}"
: "${MARIADB_PASSWORD:?Passwort fehlt}"
: "${MARIADB_DATABASE:?Datenbank fehlt}"
export MYSQL_PWD="$MARIADB_PASSWORD"
exec mariadb-dump \
--host=127.0.0.1 \
--user="$MARIADB_USER" \
--single-transaction \
--quick \
--routines \
--events \
--triggers \
--databases "$MARIADB_DATABASE"
' > "$TEMP"
;;
mysql)
docker exec "$CONTAINER" sh -ec '
: "${MYSQL_USER:?Benutzer fehlt}"
: "${MYSQL_PASSWORD:?Passwort fehlt}"
: "${MYSQL_DATABASE:?Datenbank fehlt}"
export MYSQL_PWD="$MYSQL_PASSWORD"
exec mariadb-dump \
--host=127.0.0.1 \
--user="$MYSQL_USER" \
--single-transaction \
--quick \
--routines \
--events \
--triggers \
--databases "$MYSQL_DATABASE"
' > "$TEMP"
;;
*)
echo "FEHLER: Unbekanntes Profil" >&2
exit 2
;;
esac
[[ -s "$TEMP" ]] || {
echo "FEHLER: Dump ist leer" >&2
exit 1
}
chgrp lars "$TEMP"
chmod 640 "$TEMP"
mv -f -- "$TEMP" "$TARGET"
echo "OK: $TARGET"
stat -c 'Groesse: %s Bytes' "$TARGET"
+80
View File
@@ -0,0 +1,80 @@
#!/usr/bin/env bash
set -Eeuo pipefail
umask 077
# Verwendung:
# db-postgres-docker.sh CONTAINER DATEINAME
# db-postgres-docker.sh CONTAINER DATEINAME DB_USER DB_NAME
BACKUP_DIR="/media/lars/paperless/db-backup"
if [[ $# -ne 2 && $# -ne 4 ]]; then
echo "FEHLER: Ungueltige Parameteranzahl" >&2
exit 2
fi
CONTAINER="$1"
FILENAME="$2"
if [[ ! "$FILENAME" =~ ^[a-zA-Z0-9_-]+\.sql$ ]]; then
echo "FEHLER: Ungueltiger Dateiname" >&2
exit 2
fi
if [[ ! -d "$BACKUP_DIR" || ! -w "$BACKUP_DIR" ]]; then
echo "FEHLER: Backup-Verzeichnis nicht verfuegbar" >&2
exit 1
fi
TARGET="$BACKUP_DIR/$FILENAME"
TEMP_FILE="$(mktemp "$BACKUP_DIR/.${FILENAME}.XXXXXXXX")"
trap 'rm -f -- "$TEMP_FILE"' EXIT
echo "Starte PostgreSQL-Backup: $CONTAINER"
# Standard: Datenbankparameter aus Container-Umgebung.
# Ausnahme: explizite Parameter, z.B. Mitai Dev.
if [[ $# -eq 2 ]]; then
CMD=(
docker exec "$CONTAINER"
sh -ec '
: "${POSTGRES_USER:?POSTGRES_USER fehlt}"
: "${POSTGRES_DB:?POSTGRES_DB fehlt}"
export PGPASSWORD="${POSTGRES_PASSWORD:-}"
exec pg_dump -U "$POSTGRES_USER" "$POSTGRES_DB"
'
)
else
CMD=(
docker exec "$CONTAINER"
pg_dump -U "$3" "$4"
)
fi
if "${CMD[@]}" > "$TEMP_FILE"; then
echo "Datenbankexport abgeschlossen"
else
RC=$?
echo "FEHLER: pg_dump fehlgeschlagen (Code $RC)" >&2
exit "$RC"
fi
if [[ ! -s "$TEMP_FILE" ]]; then
echo "FEHLER: Datenbank-Dump ist leer" >&2
exit 1
fi
# Auch der Benutzer lars muss die Dateien spaeter
# mit dem NAS-Kopierskript lesen koennen.
chgrp lars "$TEMP_FILE"
chmod 640 "$TEMP_FILE"
# Atomarer Austausch auf demselben Dateisystem.
mv -f -- "$TEMP_FILE" "$TARGET"
echo "OK: $TARGET"
stat -c 'Groesse: %s Bytes' "$TARGET"
exit 0
+22
View File
@@ -0,0 +1,22 @@
#!/usr/bin/env bash
set -Eeuo pipefail
UNIT=raspiBackup.service
if systemctl is-active --quiet "$UNIT"; then
echo "FEHLER: raspiBackup läuft bereits" >&2
exit 1
fi
RC=0
systemctl start --wait "$UNIT" || RC=$?
RESULT=$(systemctl show --value -p Result "$UNIT")
STATUS=$(systemctl show --value -p ExecMainStatus "$UNIT")
if (( RC != 0 )) || [[ "$RESULT" != "success" || "$STATUS" != "0" ]]; then
echo "FEHLER: raspiBackup: Result=$RESULT, Status=$STATUS" >&2
exit 1
fi
echo "OK: raspiBackup erfolgreich abgeschlossen"