POSTGRESQL / BACKUP
Backup PostgreSQL: pg_dump, cron i retencja kopii
Skrypt kopii jednej bazy z blokadą równoległego uruchomienia, rotacją po sukcesie i instrukcją odtworzenia do osobnej bazy.
Środowisko i zakresLinux, Bash, GNU coreutils/findutils, flock i klient PostgreSQL. Test wykonano na osobnym PostgreSQL 16. Paczka nie instaluje crona ani nie zmienia produkcyjnej bazy.
Co robi skrypt?
Tworzy archiwum pg_dump w formacie custom. Najpierw zapisuje plik tymczasowy, sprawdza spis archiwum, a dopiero potem nadaje nazwę .dump. Blokada flock zapobiega równoległym kopiom z tym samym prefiksem. Retencja uruchamia się wyłącznie po sukcesie.
Archiwum dotyczy jednej bazy. Nie zawiera ról globalnych, konfiguracji serwera ani plików aplikacji. Odczyt spisu archiwum nie zastępuje próbnego odtworzenia.
1. Przygotuj katalogi i konto
Użyj dedykowanego konta systemowego. Umieść rozpakowane pliki w /srv/postgres-backup i nadaj temu kontu własność katalogu. Administrator powinien przygotować prywatne katalogi kopii i sekretów poza publicznym katalogiem WWW. Dopasuj ścieżki do swojego serwera.
install -d -m 700 /srv/backups/postgres-app /srv/backup-secrets
cp backup.env.example backup.env
cp pgpass.example /srv/backup-secrets/app.pgpass
chmod 600 backup.env /srv/backup-secrets/app.pgpass2. Uzupełnij połączenie i wykonaj próbę
Uzupełnij backup.env oraz pgpass. Hasło pozostaje w prywatnym pgpass. Konto bazy musi móc odczytać wszystkie objęte kopią obiekty; nietypowe uprawnienia i RLS wymagają dopasowania. Użyj klienta zgodnego z główną wersją serwera.
Uwaga: backup.env jest wczytywany jako zaufany plik Bash. Nie używaj konfiguracji z niezaufanego źródła. Skrypt wymaga własności plików i prywatnych uprawnień.
bash backup.sh /srv/postgres-backup/backup.env3. Odtwórz na osobnej bazie
Po dostosowaniu połączenia utwórz pustą bazę testową i odtwórz wybrane archiwum. Sprawdź rzeczywiste rekordy swojej aplikacji. Opcje no-owner i no-acl ułatwiają niezależną próbę; zachowanie oryginalnych właścicieli oraz praw wymaga osobnego planu.
Uwaga: Nie kieruj polecenia odtworzenia do działającej produkcji. Nazwy bazy, archiwum i tabeli są przykładami.
createdb -T template0 app_restore_test
pg_restore --exit-on-error --single-transaction --no-owner --no-acl \
--dbname=app_restore_test /sciezka/do/app_DATA.dump
psql -X --dbname=app_restore_test -c 'SELECT count(*) FROM twoja_tabela;'4. Dopiero teraz dodaj harmonogram
Dostosuj cron.example i dodaj jedną linię do istniejącej crontab właściwego użytkownika. Przykład uruchamia kopię o 03:15 według strefy serwera. Zadbaj o rotację logu i alert przy błędzie; paczka nie wysyła powiadomień.
RETENTION_DAYS=14 używa GNU find -mtime +14, czyli pełnych dób i w praktyce co najmniej 15 dób. Usuwane są tylko pasujące pliki prefiks_*.dump w dedykowanym katalogu, bez rekursji. Kopie przechowuj także zaszyfrowane poza VPS-em.
Zakres testu i wycofanie
Potwierdzono odtworzenie dwóch rekordów, w tym polskich znaków, prawa pliku 600, zakres retencji, blokadę równoległego uruchomienia, zachowanie poprawnej kopii przy błędzie połączenia i odrzucenie zbyt szerokich uprawnień konfiguracji.
Test nie obejmuje dużych baz, wszystkich rozszerzeń ani odtworzenia całego klastra. Aby wycofać automatyzację, usuń wyłącznie dodaną linię crona; zachowaj potrzebne archiwa.
Pobierz i sprawdź u siebie
ZIP zawiera instrukcję README.md i pliki wymienione poniżej.
Pobierz ZIP (4,1 KiB) ↓Zawartość i suma SHA-256
README.mdbackup.env.examplebackup.shcron.examplepgpass.example
fbe0a62e4d1f09e1bb8e9926fa9c3a7c1308dc87526251d2b517ba51aca1f54b
Źródła i dokumentacja
Data publikacji: 29.09.2026.