notebookvb

PostGRESQLTower/postgresqlbackup_with_gzip.sh

@@ -1,24 +1,60 @@
 #!/bin/bash
+# ==============================================================================
+# PostgreSQLBackup — záloha PostgreSQL 18 (hlavní instance) na Tower
+# ==============================================================================
+#
+# CO DĚLÁ:
+#   Zálohuje celý PostgreSQL 18 server pomocí pg_dumpall — jeden SQL soubor
+#   obsahuje všechny databáze, role, tablespaces a grants. Výstup je komprimován
+#   gzip přímo ve streamu (bez mezičlánku na disku).
+#
+# TECHNICKÉ DETAILY:
+#   - pg_dumpall: záloha celého serveru (ne jen jedné DB) — zahrnuje i role/uživatele
+#   - --clean --if-exists: generuje DROP příkazy před CREATE (bezpečný re-restore)
+#   - Stream přes stdout: docker exec → pipe → gzip → soubor na hostiteli
+#     → žádný volume mount, žádná dočasná kopie uvnitř kontejneru
+#   - ${PIPESTATUS[0]}: exit kód pg_dumpall (ne gzip) — gzip by jinak maskoval chybu
+#   - PGPASSWORD: předáváme jako env var do kontejneru přes -e (ne jako argument)
+#
+# SCHEDULE:
+#   Unraid User Script "PostgreSQLBackup" — daily (4:40 ráno)
+#
+# STRUKTURA ZÁLOHY:
+#   /mnt/user/Backup/Critical/PostgreSQLBackup/tower/
+#     YYYY-MM-DD_HHMM/
+#       all_databases.sql.gz   ← komprimovaný pg_dumpall výstup
+#       all_databases.err      ← dočasný soubor chyb (smazán při úspěchu)
+#
+# VELIKOST / ČAS:
+#   Dump: ~3.3 GB, záloha trvá ~3 minuty
+#
+# ROTACE:
+#   Dvoustupňová — nejprve dle stáří (KEEP_DAYS), pak oříznutí na KEEP_COUNT.
+#
+# RESTORE:
+#   Viz postgresqlrestore_from_backup.sh
+#   gunzip -c all_databases.sql.gz | docker exec -i postgresql18 psql ...
+# ==============================================================================
 set -x
 
-# ==========================================================
-# CONFIGURATION
-# ==========================================================
-CONTAINER_NAME="postgresql18"
-PG_HOST="localhost"
-PG_PORT="5432"
-PG_USER="vladimir.buzalka"
-export PGPASSWORD="Vlado7309208104++"
+# ==============================================================================
+# KONFIGURACE
+# ==============================================================================
+CONTAINER_NAME="postgresql18"       # Docker kontejner s PostgreSQL 18
+PG_HOST="localhost"                  # uvnitř kontejneru
+PG_PORT="5432"                       # výchozí PG port
+PG_USER="vladimir.buzalka"           # superuser s právy pro pg_dumpall
+export PGPASSWORD="Vlado7309208104++" # heslo jako env var (pg_dumpall čte PGPASSWORD)
 
 UNRAID_NAME="tower"
 BASE_PATH="/mnt/user/Backup/Critical/PostgreSQLBackup"
 
-KEEP_DAYS=7
-KEEP_COUNT=7   # počet posledních záloh k udržení (mimo time-based)
+KEEP_DAYS=7    # zálohy starší než 7 dní se smažou v prvním průchodu
+KEEP_COUNT=7   # z toho co zbyde, ponech vždy alespoň 7 záloh
 
-# ==========================================================
+# ==============================================================================
 # START
-# ==========================================================
+# ==============================================================================
 echo "Starting PostgreSQL full backup (pg_dumpall)"
 START_TS=$(date '+%Y-%m-%d %H:%M:%S')
 
@@ -26,14 +62,19 @@ DATE=$(date +%Y-%m-%d_%H%M)
 FINAL_PATH="$BASE_PATH/$UNRAID_NAME/$DATE"
 mkdir -p "$FINAL_PATH"
 
-DUMP_FILE="$FINAL_PATH/all_databases.sql.gz"
-ERR_FILE="$FINAL_PATH/all_databases.err"
+DUMP_FILE="$FINAL_PATH/all_databases.sql.gz"  # výsledný komprimovaný dump
+ERR_FILE="$FINAL_PATH/all_databases.err"      # stderr pg_dumpall
 
-# ==========================================================
+# ==============================================================================
 # DUMP + GZIP
-# pg_dumpall zachovává: všechny DB, role, tablespaces, grants
-# Streamuje přes stdout, nepotřebuje volume mount
-# ==========================================================
+# docker exec spustí pg_dumpall uvnitř kontejneru.
+# -e PGPASSWORD: předá heslo jako env var do kontejneru (bez -e by pg_dumpall
+#   nemohl autentizovat a skončil by promptem na stdin).
+# Pipe na gzip: komprimuje stream v reálném čase — na disku nikdy není
+#   nekomprimovaný dump (úspora místa a I/O).
+# > "$DUMP_FILE": výstup gzip jde do souboru na hostiteli.
+# 2> "$ERR_FILE": stderr pg_dumpall (warnings, errory) jde do .err souboru.
+# ==============================================================================
 docker exec \
     -e PGPASSWORD="$PGPASSWORD" \
     "$CONTAINER_NAME" \
@@ -45,11 +86,17 @@ docker exec \
         --if-exists \
     | gzip > "$DUMP_FILE" 2> "$ERR_FILE"
 
+# PIPESTATUS[0] = exit kód prvního příkazu v pipe (pg_dumpall).
+# Prostý $? by vrátil exit kód gzip — i když pg_dumpall selže, gzip může skončit 0.
 EXIT_CODE=${PIPESTATUS[0]}
 
-# ==========================================================
-# VALIDATION
-# ==========================================================
+# ==============================================================================
+# VALIDACE
+# Tři podmínky pro úspěch:
+#   1. EXIT_CODE=0 — pg_dumpall skončil bez chyby
+#   2. -s "$DUMP_FILE" — soubor existuje a není prázdný
+#   3. ! -s "$ERR_FILE" — žádné chybové hlášky (prázdný .err)
+# ==============================================================================
 if [ $EXIT_CODE -eq 0 ] && [ -s "$DUMP_FILE" ] && [ ! -s "$ERR_FILE" ]; then
     echo "SUCCESS: Full PostgreSQL backup completed"
     echo "Dump size: $(du -h "$DUMP_FILE" | cut -f1)"
@@ -63,17 +110,20 @@ else
     [ -s "$ERR_FILE" ] && cat "$ERR_FILE" || echo "  (no stderr output)"
 fi
 
-# ==========================================================
-# CLEANUP OLD BACKUPS
-# 1. Smaž zálohy starší než KEEP_DAYS dnů
-# 2. Z toho co zbyde, ponech jen posledních KEEP_COUNT
-# ==========================================================
+# ==============================================================================
+# ROTACE STARÝCH ZÁLOH — dvoustupňová
+#
+# Krok 1: Smaž adresáře starší než KEEP_DAYS dní.
+#   -mindepth/-maxdepth 1: jen přímé podadresáře (ne rekurzivně)
+#
+# Krok 2: Z toho co zbyde, ponech jen posledních KEEP_COUNT.
+#   Důvod dvou kroků: i při přerušeném schedule garantuje min. KEEP_COUNT záloh.
+# ==============================================================================
 echo "Cleaning up old backups..."
 find "$BASE_PATH/$UNRAID_NAME" \
     -mindepth 1 -maxdepth 1 -type d -mtime +$KEEP_DAYS \
     -exec rm -rf {} \;
 
-# Nech jen posledních KEEP_COUNT záloh
 ls -td "$BASE_PATH/$UNRAID_NAME"/*/ 2>/dev/null \
     | tail -n +$((KEEP_COUNT + 1)) \
     | xargs -r rm -rf