Nikola Derežić
4454ea3b7e
Database Backup Scripts: - Add db-dump--standalone.sh for online database dumps (no downtime) - Add db-restore-from-dump--standalone.sh for restoring from dumps - Rename backup scripts with double-dash convention for clarity - Add comprehensive header comments to all backup/restore scripts - Document online vs offline, standalone vs swarm deployment types - Add KEEP variable default (7) to dump script for rotation Docker Configuration: - Add mongo-backup volume mount to docker-compose-standalone.yaml - Add mongo-backup volume mount to docker-compose-debug.yml - Add container names to debug compose for consistency with standalone Documentation: - Add comprehensive Database Backup & Restore section to README.md - Document all backup scripts with usage examples - Document automated cron schedule (04:00 daily) - Sunday: Full volume backup (KEEP=2, offline) - Monday-Saturday: Database dumps (KEEP=7, online) - Document backup directories and log file locations Git Configuration: - Add mongo-backup/ to .gitignore - Fix missing newline at end of .gitignore File Cleanup: - Remove db-scheduled-backup.sh (superseded by cron jobs) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
71 lines
2.2 KiB
Bash
Executable File
71 lines
2.2 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
# ==============================================================================
|
|
# MongoDB Offline Volume Backup Script (Docker Swarm)
|
|
# ==============================================================================
|
|
#
|
|
# PURPOSE:
|
|
# Creates an offline backup of the complete mongo-volume directory.
|
|
# The MongoDB service is scaled down during the backup to ensure consistency.
|
|
#
|
|
# WHEN TO USE:
|
|
# - For Docker Swarm deployments (not standalone Docker)
|
|
# - When you need a complete volume backup (entire MongoDB data directory)
|
|
# - For disaster recovery scenarios
|
|
# - When consistency is critical and downtime is acceptable
|
|
#
|
|
# BACKUP TYPE:
|
|
# - Offline (cold) backup - DB service is scaled to 0 during backup
|
|
# - Volume-level backup - entire mongo-volume directory
|
|
# - Creates compressed tarball (.tar.gz) of the volume
|
|
#
|
|
# OUTPUT:
|
|
# - Backup files stored in: ./backups/
|
|
# - Filename format: mongo-volume-backup-YYYY-MM-DD-HH-MM.tar.gz
|
|
# - Automatic rotation: keeps newest 7 backups (configurable via KEEP env var)
|
|
#
|
|
# USAGE:
|
|
# ./db-backup--swarm.sh
|
|
# KEEP=10 ./db-backup--swarm.sh # Keep 10 backups instead of 7
|
|
#
|
|
# NOTE:
|
|
# The MongoDB service will be scaled down to 0 and then back up to 1.
|
|
# Expect brief downtime during the backup process.
|
|
#
|
|
# ==============================================================================
|
|
|
|
# Configuration
|
|
MONGO_SERVICE="utility-bills-tracker_mongo"
|
|
|
|
# scale down mongo service while we copy its volume
|
|
docker service scale "$MONGO_SERVICE"=0
|
|
|
|
# timestamp for filename
|
|
TIMESTAMP=$(date +"%Y-%m-%d-%H-%M")
|
|
|
|
# backup directory and retention (can be overridden via env)
|
|
BACKUP_DIR="${BACKUP_DIR:-backups}"
|
|
KEEP="${KEEP:-7}"
|
|
|
|
mkdir -p "$BACKUP_DIR"
|
|
|
|
BACKUP_FILE="$BACKUP_DIR/mongo-volume-backup-$TIMESTAMP.tar.gz"
|
|
|
|
sudo tar -czvpf "$BACKUP_FILE" mongo-volume
|
|
|
|
# rotate old backups: keep only the newest $KEEP files
|
|
if [ "$KEEP" -gt 0 ]; then
|
|
# gather files sorted newest-first
|
|
mapfile -t files < <(ls -1t "$BACKUP_DIR"/mongo-volume-backup-*.tar.gz 2>/dev/null || true)
|
|
if [ "${#files[@]}" -gt "$KEEP" ]; then
|
|
for f in "${files[@]:$KEEP}"; do
|
|
echo "Removing old backup: $f"
|
|
rm -f -- "$f"
|
|
done
|
|
fi
|
|
fi
|
|
|
|
# bring mongo service back up
|
|
docker service scale "$MONGO_SERVICE"=1
|