chore: import v0.3.0 baseline and add v0.4 recovery architecture plan
This commit is contained in:
commit
40188c0e10
12 files changed
+1506
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
|
||||
@@ -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"
|
||||
@@ -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
|
||||
@@ -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"
|
||||
Reference in new issue
Block a user