Files
Backup/KanboardBackup/kanboard_backup.sh
T
Administrator 916ab42bcc notebookvb
2026-05-23 09:38:53 +02:00

100 lines
4.7 KiB
Bash

#!/bin/bash
# ==============================================================================
# KanboardBackup — záloha Docker appdata kontejneru Kanboard
# ==============================================================================
#
# CO DĚLÁ:
# Zastaví kontejner Kanboard, zazálohuje celý jeho appdata adresář jako tar.gz,
# pak kontejner znovu nastartuje. Záloha obsahuje konfiguraci, pluginy,
# uploadované soubory a lokální data Kanboard.
#
# POZNÁMKA K DATABÁZI:
# Kanboard používá MySQL — ta je zálohována samostatně skriptem
# 3_MYSQL_BACKUP_WITH_GZIP (databáze "kanboard"). Tento skript zálohuje
# pouze appdata (souborová část aplikace), nikoli databázi.
#
# PROČ STOP/START:
# Kanboard může zapisovat do souborů (session, cache, uploady) za běhu.
# Stop zaručí konzistentní snapshot bez rizika poškozených souborů v archivu.
#
# SCHEDULE:
# Spouštěn jako Unraid User Script "KanboardBackup" — daily (4:40 ráno).
#
# STRUKTURA ZÁLOHY:
# /mnt/user/Backup/Critical/KanboardBackup/tower/kanboard_YYYYMMDD_HHMMSS.tar.gz
#
# ROTACE:
# Zálohy starší než KEEP_DAYS dní jsou automaticky mazány.
#
# RESTORE:
# tar -xzf kanboard_DATUM.tar.gz -C /mnt/user/appdata
# (pak docker start kanboard)
# Databázi obnovit zvlášť z MySQL zálohy.
# ==============================================================================
CONTAINER="kanboard" # název kontejneru v Unraid
APPDATA_DIR="/mnt/user/appdata/kanboard" # zdrojový adresář dat Kanboard
BACKUP_DIR="/mnt/user/Backup/Critical/KanboardBackup/tower" # kam se zálohy ukládají
DATE=$(date +%Y%m%d_%H%M%S) # timestamp pro unikátní název souboru
BACKUP_FILE="${BACKUP_DIR}/kanboard_${DATE}.tar.gz" # výsledný archiv
KEEP_DAYS=7 # počet dní po které se zálohy uchovávají
mkdir -p "${BACKUP_DIR}"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Starting Kanboard backup"
# ------------------------------------------------------------------------------
# STOP KONTEJNERU
# Zastavíme Kanboard před zálohou — souborový systém appdata (uploady, cache,
# sessions) musí být v klidovém stavu pro konzistentní archiv.
# Pokud stop selže, skript okamžitě skončí — nechceme zálohovat za běhu.
# ------------------------------------------------------------------------------
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Stopping container: ${CONTAINER}"
docker stop "${CONTAINER}"
if [ $? -ne 0 ]; then
echo "[$(date '+%Y-%m-%d %H:%M:%S')] ERROR: Failed to stop container"
exit 1
fi
# ------------------------------------------------------------------------------
# VYTVOŘENÍ ARCHIVU
# tar -czf: gzip-komprimovaný archiv
# -C /mnt/user/appdata: pracovní adresář pro tar (cesta v archivu bude relativní)
# kanboard: zazálohuje podadresář "kanboard"
# BACKUP_STATUS se kontroluje až po startu kontejneru — Kanboard nesmí zůstat
# offline kvůli chybě archivace.
# ------------------------------------------------------------------------------
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Creating backup: ${BACKUP_FILE}"
tar -czf "${BACKUP_FILE}" -C /mnt/user/appdata kanboard
BACKUP_STATUS=$?
# ------------------------------------------------------------------------------
# START KONTEJNERU — vždy, bez ohledu na výsledek zálohy
# Záměrně před kontrolou BACKUP_STATUS: downtime Kanboard musí být minimální.
# ------------------------------------------------------------------------------
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Starting container: ${CONTAINER}"
docker start "${CONTAINER}"
# ------------------------------------------------------------------------------
# KONTROLA VÝSLEDKU ZÁLOHY
# Neúplný archiv (tar selhal) smažeme — je k ničemu a zabírá místo.
# ------------------------------------------------------------------------------
if [ ${BACKUP_STATUS} -ne 0 ]; then
echo "[$(date '+%Y-%m-%d %H:%M:%S')] ERROR: tar failed with exit code ${BACKUP_STATUS}"
rm -f "${BACKUP_FILE}"
exit 1
fi
BACKUP_SIZE=$(du -sh "${BACKUP_FILE}" | cut -f1)
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Backup complete: ${BACKUP_FILE} (${BACKUP_SIZE})"
# ------------------------------------------------------------------------------
# ROTACE STARÝCH ZÁLOH
# -mtime +N: soubory starší než N dní (počítáno dle mtime = last modification)
# -delete: atomické mazání bez mezikroku
# ------------------------------------------------------------------------------
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Removing backups older than ${KEEP_DAYS} days"
find "${BACKUP_DIR}" -name "kanboard_*.tar.gz" -mtime +${KEEP_DAYS} -delete
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Done"