Логический бэкап PostgreSQL
Создаёт pg_dump или pg_dumpall, проверяет архив и считает SHA-256.
Что делает скрипт
Скрипт делает логическую резервную копию базы или всего кластера, по умолчанию в custom-формате. Сначала показывается план и размер базы, запись выполняется с --apply. После дампа проверяется читаемость через pg_restore или gzip и сохраняется контрольная сумма.
- Бэкап содержит данные и метаданные ролей. Храните файл с правами 0600 и не передавайте его в открытом виде.
Быстрый старт
bash postgres_backup.sh --database app --output /var/backups/postgres
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
Другие варианты
bash postgres_backup.sh --database app --output /var/backups/postgresbash postgres_backup.sh --database app --output /var/backups/postgres --format plain --applybash postgres_backup.sh --all --host db.example.com --user backup --output /srv/backups --apply
Что понадобится
sudo apt install bash
sudo apt install postgresql-client
sudo apt install gzip
postgres_backup.sh
#!/usr/bin/env bash
set -euo pipefail
usage() {
cat <<'EOF'
Использование: postgres_backup.sh (--database NAME | --all) --output DIR
[--host HOST] [--port PORT] [--user USER]
[--format custom|plain] [--apply]
Создаёт логический бэкап PostgreSQL. Без --apply только показывает план.
Пароль не передаётся в командной строке, используйте .pgpass или peer-аутентификацию.
EOF
}
database=""
output_dir=""
host=""
port="5432"
user=""
format="custom"
all=0
apply=0
while [[ $# -gt 0 ]]; do
case "$1" in
--database|-d) [[ $# -ge 2 ]] || exit 2; database="$2"; shift 2 ;;
--output|-o) [[ $# -ge 2 ]] || exit 2; output_dir="$2"; shift 2 ;;
--host) [[ $# -ge 2 ]] || exit 2; host="$2"; shift 2 ;;
--port) [[ $# -ge 2 ]] || exit 2; port="$2"; shift 2 ;;
--user) [[ $# -ge 2 ]] || exit 2; user="$2"; shift 2 ;;
--format) [[ $# -ge 2 ]] || exit 2; format="$2"; shift 2 ;;
--all) all=1; shift ;;
--apply) apply=1; shift ;;
-h|--help) usage; exit 0 ;;
*) echo "Неизвестный аргумент: $1" >&2; usage >&2; exit 2 ;;
esac
done
[[ -n "$output_dir" ]] || { echo "Укажите каталог через --output" >&2; exit 2; }
[[ -n "$database" || "$all" -eq 1 ]] || { echo "Укажите --database или --all" >&2; exit 2; }
[[ "$format" == "custom" || "$format" == "plain" ]] || { echo "--format: custom или plain" >&2; exit 2; }
[[ "$port" =~ ^[0-9]+$ ]] || { echo "--port должен быть числом" >&2; exit 2; }
command -v pg_dump >/dev/null 2>&1 || { echo "pg_dump не найден. Установите postgresql-client." >&2; exit 2; }
if ((all == 1)); then
command -v pg_dumpall >/dev/null 2>&1 || { echo "pg_dumpall не найден." >&2; exit 2; }
command -v gzip >/dev/null 2>&1 || { echo "gzip не найден." >&2; exit 2; }
fi
conn=()
[[ -n "$host" ]] && conn+=(-h "$host")
[[ -n "$port" ]] && conn+=(-p "$port")
[[ -n "$user" ]] && conn+=(-U "$user")
if command -v pg_isready >/dev/null 2>&1; then
if pg_isready "${conn[@]}" >/dev/null 2>&1; then
echo "PostgreSQL доступен."
else
echo "[WARN] pg_isready не подтвердил доступ к серверу." >&2
fi
fi
if ((all == 0)) && command -v psql >/dev/null 2>&1; then
size="$(psql "${conn[@]}" -d "$database" -tAc 'select pg_size_pretty(pg_database_size(current_database()))' 2>/dev/null || true)"
[[ -n "$size" ]] && echo "Размер базы $database: $size"
fi
timestamp="$(date +%Y%m%d-%H%M%S)"
if ((all == 1)); then
target="$output_dir/all-$timestamp.sql.gz"
elif [[ "$format" == "custom" ]]; then
target="$output_dir/$database-$timestamp.dump"
else
target="$output_dir/$database-$timestamp.sql"
fi
cmd=()
if ((all == 1)); then
echo "Режим: pg_dumpall | gzip"
else
if [[ "$format" == "custom" ]]; then
cmd=(pg_dump "${conn[@]}" -Fc -Z 6 -f "$target" "$database")
else
cmd=(pg_dump "${conn[@]}" -Fp -f "$target" "$database")
fi
printf 'Команда: '
printf '%q ' "${cmd[@]}"
echo
fi
echo "Архив: $target"
if ((apply == 0)); then
echo
echo "Это предпросмотр. Для создания бэкапа добавьте --apply."
exit 0
fi
mkdir -p "$output_dir"
[[ -w "$output_dir" ]] || { echo "Каталог недоступен для записи: $output_dir" >&2; exit 2; }
umask 077
if ((all == 1)); then
pg_dumpall "${conn[@]}" | gzip -9 > "$target"
else
"${cmd[@]}"
fi
chmod 0600 "$target"
if ((all == 1)); then
gzip -t "$target"
elif [[ "$format" == "custom" ]]; then
command -v pg_restore >/dev/null 2>&1 || { echo "pg_restore не найден, проверка пропущена." >&2; }
if command -v pg_restore >/dev/null 2>&1; then
pg_restore --list "$target" >/dev/null
fi
else
[[ -s "$target" ]] || { echo "Дамп пуст: $target" >&2; exit 1; }
fi
sha256sum "$target" | tee "$target.sha256"
echo "Бэкап готов: $target"
if ((all == 1)); then
echo "Восстановление: gunzip -c \"$target\" | psql"
elif [[ "$format" == "custom" ]]; then
echo "Восстановление: pg_restore -d \"$database\" \"$target\""
else
echo "Восстановление: psql -d \"$database\" -f \"$target\""
fi
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.