refactor(hosts): organize repository by server profiles (hosts/raspberrypi5, hosts/llm-node) and add host-aware installer

This commit is contained in:
Lars committed 2026-10-29 14:27:49 +01:00
1 parent c53fc0a939
commit c2740c9542
44 files changed
+528 -40

No files matched your search

@@ -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