Jak wykonać kopię zapasową i aktualizację Docker Compose
Dowiedz się, jak poprawnie zabezpieczyć stos Docker Compose przed aktualizacją. Poradnik omawia procedurę zrzutu bazy danych, kopiowania wolumenów oraz weryfikacji przywracania.
Co musi zawierać kopia zapasowa stosu Docker Compose
Kopia zapasowa stosu Docker Compose musi obejmować cztery odrębne elementy, a utrata któregokolwiek z nich uniemożliwia przywrócenie aplikacji: plik compose, plik .env znajdujący się obok niego, zawartość każdego wolumenu oraz zrzut bazy danych wykonany przez natywnego klienta bazy danych. Kopiowanie plików bazy danych w trakcie działania kontenera nie jest kopią zapasową. Aktualizacje wymagają tej samej listy oraz jednej zasady: wykonaj kopię zapasową przed pobraniem nowych obrazów, ponieważ migracje schematu są projektowane do działania w jednym kierunku, a większość projektów nie oferuje ścieżki powrotnej.
Wszystkie poniższe instrukcje zakładają, że stos jest już wdrożony, a polecenie docker compose ps potwierdza jego działanie. Przykłady wykorzystują katalog projektu /srv/myapp z usługami o nazwach app oraz db. Należy podstawić własne nazwy. Polecenia celowo pozostawiono w formie ogólnej, ponieważ kluczowe elementy, takie jak wolumeny i baza danych, działają w ten sam sposób niezależnie od aplikacji.
Ustalenie, co faktycznie przechowuje stos
cd /srv/myapp
docker compose ps
docker compose config --volumes
docker volume ls --filter label=com.docker.compose.project=myappdocker compose config --volumes wyświetla krótkie nazwy wolumenów nazwanych zadeklarowanych w pliku. docker volume ls wyświetla nazwy, które te wolumeny faktycznie posiadają na dysku. Listy te różnią się, ponieważ Compose dodaje nazwę projektu przed nazwą wolumenu: wolumen zapisany jako db_data w pliku istnieje jako myapp_db_data. Nazwa projektu domyślnie odpowiada nazwie katalogu, więc zmiana nazwy katalogu powoduje, że stos wskazuje na nowy zestaw pustych wolumenów, pozostawiając stare z danymi na dysku. Każde poniższe polecenie wymaga użycia rzeczywistej nazwy z docker volume ls.
Montowania typu bind mounts nie pojawiają się na żadnej z tych list. W pliku compose są to wpisy ze ścieżką hosta po lewej stronie dwukropka, ./config:/app/config. Są to zwykłe katalogi na hoście, więc standardowe narzędzia mają do nich dostęp. Wolumeny nazwane znajdują się w /var/lib/docker/volumes/, a docker volume inspect --format '{{.Mountpoint}}' myapp_db_data wyświetla dokładną ścieżkę wybranego wolumenu. Rodzaj używanego rozwiązania wpływa na sposób kopiowania danych, a porównanie bind mounts i wolumenów nazwanych szczegółowo omawia różnice między nimi.
Teraz należy podzielić znalezione elementy na dwie grupy. Niektóre wolumeny przechowują stan, którego nie da się odtworzyć: przesłane pliki, wygenerowane klucze, samą bazę danych oraz wszystko, co użytkownik wprowadził do aplikacji. Inne przechowują dane pochodne, takie jak miniatury czy indeksy wyszukiwania, które aplikacja może samodzielnie odbudować. Tworzenie kopii zapasowych drugiej grupy zajmuje miejsce na dysku i wydłuża czas przywracania, nie przynosząc żadnych korzyści. Wolumen pamięci podręcznej Redis jest najbardziej wyrazistym przykładem: jego utrata skutkuje jedynie jednym wolniejszym pierwszym żądaniem.
Tworzenie kopii zapasowej pliku compose oraz pliku .env
Oba pliki znajdują się na hoście obok siebie i żaden z nich nie jest częścią wolumenu. Plik .env przechowuje hasło do bazy danych, sekret aplikacji oraz wszelkie tokeny API, dlatego to właśnie ten plik pozwala przywrócić zestaw wolumenów do stanu działającej aplikacji. Zazwyczaj jest on również uwzględniony w .gitignore, co oznacza, że strategia „moja konfiguracja jest w git” pomija najważniejszy plik. Przechowywanie sekretów w pliku env jest właściwym wzorcem, który nakłada na użytkownika obowiązek uwzględnienia tego pliku w kopii zapasowej.
sudo install -d -m 700 -o "$USER" -g "$(id -gn)" /srv/backups/myapp
cp -a compose.yaml .env /srv/backups/myapp/
chmod 600 /srv/backups/myapp/.envSkopiuj każdy plik compose używany przez stos, a nie tylko pierwszy z nich. Stos uruchomiony za pomocą -f compose.yaml -f compose.prod.yaml wymaga obu plików, aby przywrócenie przebiegło w ten sam sposób, a sposób łączenia wielu plików compose decyduje o tym, które wartości faktycznie trafią do kontenera.
Jedno ostrzeżenie wiąże .env z wolumenami. Oficjalny obraz Postgres odczytuje POSTGRES_PASSWORD tylko podczas inicjalizacji pustego katalogu danych. Zmiana tej wartości w późniejszym czasie nie zmienia hasła wewnątrz bazy danych. Przywrócenie wolumenu sprzed miesiąca obok dzisiejszego .env spowoduje błąd połączenia aplikacji z komunikatem FATAL: password authentication failed for user "appuser", mimo że oba pliki wyglądają na poprawne podczas inspekcji. Przechowuj .env oraz wolumeny pochodzące z tego samego momentu razem w tej samej kopii zapasowej.
Zrzut bazy danych za pomocą dedykowanego klienta
Serwer bazy danych stale zapisuje dane do swoich plików. tar wykonana za pomocą /var/lib/postgresql/data w trakcie pracy serwera kopiuje niektóre strony przed zapisem, a inne po nim, przez co archiwum zawiera mieszankę stanów, których nie da się odtworzyć. Narzędzie do zrzutu odczytuje dane w ramach pojedynczej transakcji, dzięki czemu plik reprezentuje jeden spójny moment w czasie. Ta różnica odróżnia kopię zapasową od zwykłego pliku.
docker compose exec -T db sh -c \
'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
> /srv/backups/myapp/db-$(date +%F).dumpNależy zachować flagę -T. Wyłącza ona alokację TTY; z podłączonym TTY, Docker tłumaczy strumień wyjściowy w drodze do powłoki, co powoduje uszkodzenie binarnego zrzutu. O tym fakcie dowiesz się dopiero w momencie nieudanego przywracania danych. Pojedyncze cudzysłowy również mają znaczenie: zapobiegają one rozwijaniu $POSTGRES_USER przez powłokę hosta, dzięki czemu zmienna jest rozwijana wewnątrz kontenera, wykorzystując wartości zdefiniowane w pliku compose. -Fc zapisuje dane w formacie niestandardowym, który kompresuje zawartość w locie i pozwala narzędziu pg_restore na późniejsze wyodrębnianie poszczególnych obiektów.
Role oraz ich hasła znajdują się poza pojedynczą bazą danych, więc należy je również uwzględnić:
docker compose exec -T db sh -c 'pg_dumpall -U "$POSTGRES_USER" --globals-only' \
> /srv/backups/myapp/globals.sqlNastępnie należy sprawdzić, czy plik jest poprawnym zrzutem, a nie komunikatem o błędzie:
ls -lh /srv/backups/myapp/
head -c 5 /srv/backups/myapp/db-$(date +%F).dumpZrzut w formacie niestandardowym rozpoczyna się od pięciu bajtów PGDMP. Plik o zerowej długości lub rozpoczynający się od pg_dump: oznacza, że polecenie zakończyło się niepowodzeniem. Powłoka tworzy plik wyjściowy przed uruchomieniem polecenia, więc nieudany zrzut pozostawia po sobie plik o wiarygodnej nazwie i sygnaturze czasowej. Jest to najczęstsza przyczyna cichej awarii kopii zapasowych.
W przypadku MariaDB lub MySQL klient ulega zmianie, ale schemat działania pozostaje ten sam:
docker compose exec -T db sh -c \
'mariadb-dump -u root -p"$MARIADB_ROOT_PASSWORD" --single-transaction --databases "$MARIADB_DATABASE"' \
> /srv/backups/myapp/db-$(date +%F).sql--single-transaction zapewnia spójny zrzut tabel InnoDB bez blokowania operacji zapisu. W obrazie MySQL polecenie to mysqldump, a zmienne to MYSQL_ROOT_PASSWORD oraz MYSQL_DATABASE. W obrazie MariaDB, począwszy od wersji 11.0, usunięto nazwę kompatybilności mysqldump, więc starsze skrypty, które ją wywołują, kończą się błędem i wymagają użycia mariadb-dump. Należy pamiętać, że hasło podane w wierszu poleceń jest widoczne na liście procesów kontenera przez cały czas trwania zrzutu.
SQLite wymaga szczególnej uwagi. Baza danych to jeden plik, ale niedawne transakcje mogą nadal znajdować się w oddzielnym pliku -wal obok niej, więc skopiowanie tylko .db spowoduje utratę najnowszych zapisów. Jeśli obraz zawiera klienta, sqlite3 /data/app.db ".backup '/data/app-backup.db'" zapisze spójną kopię podczas pracy aplikacji. Jeśli go nie zawiera, należy zatrzymać kontener i skopiować plik .db wraz z jego towarzyszącymi plikami -wal oraz -shm.
Jeśli baza danych działa na hoście, a nie wewnątrz stosu, mają zastosowanie te same polecenia bez prefiksu docker compose exec, a lektura uruchamianie bazy danych w Dockerze lub na hoście jest zalecana przed kolejną przebudową środowiska.
Przechwytywanie wolumenów
Nazwany wolumen nie posiada ścieżki w systemie hosta, którą można edytować ręcznie, dlatego należy zamontować go w tymczasowym kontenerze i stamtąd zarchiwizować.
docker run --rm \
-v myapp_uploads:/data:ro \
-v /srv/backups/myapp:/backup \
alpine:3 tar czf /backup/uploads.tar.gz -C /data .Kontener pomocniczy montuje wolumen w trybie tylko do odczytu w /data, a katalog kopii zapasowej w /backup, po czym zapisuje archiwum po stronie hosta. --rm usuwa kontener pomocniczy natychmiast po zakończeniu tar. Parametr :ro jest istotny, ponieważ w przypadku błędnego wpisania polecenia tar, źródło pozostaje bezpieczne. -C /data . zapewnia poprawne odtworzenie danych: przechowuje każdą ścieżkę w odniesieniu do katalogu głównego wolumenu. Użycie tar czf /backup/uploads.tar.gz /data spowodowałoby dodanie wiodącego data/ do każdej ścieżki, przez co przywracanie utworzyłoby /data/data wewnątrz wolumenu, a aplikacja widziałaby pusty katalog. Archiwum należy do użytkownika root, ponieważ tar został uruchomiony z uprawnieniami roota wewnątrz kontenera. Uruchom sudo chown "$USER" /srv/backups/myapp/uploads.tar.gz, jeśli stanowi to problem, i przeczytaj jak PUID i PGID decydują o własności plików, jeśli przywrócone pliki są nieczytelne dla aplikacji.
Wykonaj to polecenie dla każdego nazwanego wolumenu z osobna. W przypadku bind mounts kontener nie jest potrzebny: tar czf /srv/backups/myapp/config.tar.gz -C /srv/myapp/config . wykonuje to samo zadanie bezpośrednio na hoście.
Dla każdego wolumenu zdecyduj, czy aplikacja musi zostać zatrzymana. Archiwizacja na żywo wolumenu, w którym aplikacja nadpisuje pliki, może spowodować przechwycenie pliku w trakcie zapisu. W przypadku katalogu z przesłanymi plikami, gdzie dane są zapisywane raz, a następnie tylko odczytywane, ryzyko jest niewielkie. W każdym innym przypadku zatrzymaj usługę na czas kopiowania za pomocą docker compose stop app, a następnie docker compose start app. stop pozostawia kontenery i wolumeny w systemie, co jest pożądanym zachowaniem w tym scenariuszu; warto upewnić się, że różnica między down a stop jest zrozumiała przed wydaniem któregokolwiek z tych poleceń.
Nie traktuj archiwum tar wolumenu bazy danych jako pełnej kopii zapasowej bazy. Kopia zapasowa to zrzut bazy (dump). Archiwum wolumenu zatrzymanej bazy danych jest jedynie użytecznym sposobem na szybkie odtworzenie stanu, niczym więcej.
Kolejność operacji
- Skopiuj pliki compose oraz
.envdo katalogu kopii zapasowej. - Wykonaj zrzut bazy danych, gdy jest ona jeszcze uruchomiona.
- Zatrzymaj kontener aplikacji, jeśli jego wolumeny ulegają zmianie w miejscu.
- Zarchiwizuj każdy nazwany wolumen oraz każdy katalog montowany przez bind-mount.
- Uruchom wszystko, co zostało zatrzymane, a następnie potwierdź działanie za pomocą
docker compose ps. - Zapisz tagi obrazów oraz sumy kontrolne digest, na których działa stos.
- Skopiuj cały katalog kopii zapasowej poza ten serwer.
Krok 7 jest tym, który często odkłada się na później.
Przeniesienie kopii zapasowej poza serwer
Kopia zapasowa przechowywana na tym samym dysku co dane produkcyjne chroni jedynie przed błędami użytkownika. Awaria wolumenu, usunięcie serwera lub utrata dostępu do konta powoduje jednoczesną utratę obu kopii. Należy przesyłać katalog z danymi do zewnętrznej pamięci masowej zgodnie z harmonogramem i polityką retencji. Artykuł kopie zapasowe restic z VPS opisuje konfigurację repozytorium, flagi retencji oraz polecenie weryfikacji, dlatego te informacje nie będą tutaj powtarzane.
Narzędzie restic potrafi również odczytać zrzut bezpośrednio ze strumienia, co pozwala uniknąć zapisu niezaszyfrowanej bazy danych na dysku:
docker compose exec -T db sh -c 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
| restic backup --stdin --stdin-filename db.dumpNiezależnie od wybranego narzędzia, należy umieścić harmonogram w timerze systemd lub zadaniu cron, a także skonfigurować powiadamianie o błędach. Skrypt kopii zapasowej, którego wyjście nie jest monitorowane, może przestać działać na wiele miesięcy bez wiedzy administratora.
Weryfikacja kopii zapasowej poprzez próbne przywracanie
Kopia zapasowa, która nie została przywrócona, jest jedynie hipotezą. Poniższa procedura przywraca dane do drugiego stosu działającego obok pierwszego, dzięki czemu środowisko produkcyjne pozostaje aktywne, a wprowadzane polecenia nie mają na nie wpływu.
Mechanizm opiera się na nazwie projektu. Compose pobiera ją z nazwy katalogu i przypisuje do każdego tworzonego kontenera oraz wolumenu. Skopiowanie kopii zapasowej do nowego katalogu powoduje, że przywrócony stos automatycznie otrzymuje własne wolumeny.
sudo install -d -m 700 -o "$USER" -g "$(id -gn)" /srv/myapp-restore
cd /srv/myapp-restore
cp /srv/backups/myapp/compose.yaml /srv/backups/myapp/.env .Należy edytować skopiowany plik compose, aby opublikowany port hosta nie kolidował z działającym stosem, używając 18080:8080 zamiast 8080:8080, lub zmieniając zmienną, która definiuje go w skopiowanym .env. Następnie należy utworzyć kontenery i ich puste wolumeny bez uruchamiania czegokolwiek:
docker compose create
docker volume ls --filter label=com.docker.compose.project=myapp-restoreDrugie polecenie powinno wyświetlić te same nazwy wolumenów co na produkcji, z przedrostkiem myapp-restore_. Należy je wypełnić, uruchomić samą bazę danych i wczytać zrzut:
docker run --rm -v myapp-restore_uploads:/data -v /srv/backups/myapp:/backup \
alpine:3 tar xzf /backup/uploads.tar.gz -C /data
docker compose up -d db
docker compose exec -T db sh -c \
'pg_restore -U "$POSTGRES_USER" -d "$POSTGRES_DB" --clean --if-exists' \
< /srv/backups/myapp/db-2026-08-16.dump--clean --if-exists usuwa każdy obiekt przed jego ponownym utworzeniem, co sprawia, że przywracanie jest powtarzalne. Bez tego parametru drugie uruchomienie w bazie danych, która już zawiera te tabele, zakończy się błędem pg_restore: error: could not execute query: ERROR: relation "users" already exists.
Następnie należy uruchomić resztę usług i sprawdzić je w sposób, w jaki zrobiłby to użytkownik:
docker compose up -d --wait
docker compose exec -T db sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -c "\\dt"'
docker compose logs --tail=50docker compose up -d --wait blokuje działanie do momentu, aż każda usługa zgłosi stan uruchomienia lub gotowości, a w przypadku niepowodzenia którejkolwiek z nich, kończy się kodem błędu, co pozwala na automatyzację tego kroku. Gdy usługa nie osiąga stanu gotowości, docker compose ps -a pokazuje jej stan, w tym usługi, które już zakończyły działanie, co pomija zwykłe docker compose ps. Kontrole stanu Compose wyjaśniają, co odczytuje ta kolumna. Następnie należy otworzyć aplikację na alternatywnym porcie i zalogować się na rzeczywiste konto. Należy zapisać jeden rekord i otworzyć jeden plik znajdujący się w wolumenie. Ta para stanowi dowód: zrzut został przywrócony, wolumen został przywrócony, a oba elementy są ze sobą spójne. Próba, która potwierdza jedynie wyświetlenie strony logowania, nie stanowi dowodu na poprawność danych.
Po pomyślnym zakończeniu testu należy usunąć środowisko testowe:
docker compose down -vJest to jedyne miejsce, w którym -v jest właściwą flagą. W katalogu produkcyjnym to samo polecenie usunie wolumeny, które mają zostać zachowane.
Jak aktualizować stos Compose
Przeczytaj informacje o wydaniu dla każdej wersji pomiędzy tą, której używasz, a tą, którą chcesz zainstalować. Wyszukaj w nich słowa breaking oraz migration. Projekty, które nie wspierają przeskakiwania kilku wersji głównych, informują o tym w dokumentacji. Migracja, która przerywa działanie, zgłasza błąd dopiero po tym, jak zmieniła część schematu.
Zapisz stan obecny przed wprowadzeniem jakichkolwiek zmian:
docker compose images
docker image inspect --format '{{index .RepoDigests 0}}' postgres:16.4docker compose images wyświetla obraz oraz tag, którego używa obecnie każda usługa. Digest jest jedyną wartością, która precyzyjnie wskazuje obraz, ponieważ tag może zostać w każdej chwili przeniesiony w inne miejsce.
Wykonaj kopię zapasową zgodnie z powyższymi sekcjami i skopiuj ją poza serwer. Zrób to również w przypadku aktualizacji typu patch. Tanie aktualizacje to te, do których ludzie przestają się przygotowywać.
Następnie przypnij wersję w pliku compose, ponieważ latest nie jest wersją:
services:
db:
image: postgres:16.4Przy użyciu image: postgres:latest, docker compose pull pobiera to, na co aktualnie wskazuje dany tag, i nie masz możliwości określenia, co było uruchomione wczoraj. Przypięty tag zamienia aktualizację w edycję jednej linii, którą możesz odczytać w git diff i cofnąć za pomocą kolejnej edycji. Przypnij obraz aplikacji w ten sam sposób, pobierając dokładną wersję ze strony wydania projektu.
Pobierz i odtwórz:
docker compose pull
docker compose up -d --waitdocker compose up -d porównuje plik z uruchomionymi kontenerami i odtwarza tylko te usługi, których obraz lub konfiguracja uległy zmianie. Nie ingeruje w nazwane wolumeny, więc nowy kontener uruchamia się na istniejących danych. To jest cel tego działania, ale również ryzyko, ponieważ pierwszy start nowej wersji to zazwyczaj moment, w którym uruchamia się migracja schematu.
Obserwuj proces:
docker compose ps -a
docker compose logs -f --tail=100 appZwykłe docker compose ps wyświetla tylko uruchomione kontenery, więc kontener, który uległ awarii, po prostu znika z listy. Z flagą -a pozostaje on na liście, z exited (1) lub innym kodem różnym od zera w kolumnie STATUS, a przyczyna znajduje się w ostatnich liniach dziennika. Błędy migracji są tam wyraźnie widoczne, podczas gdy w innych miejscach pozostają niewidoczne. Gdy dzienniki się ustabilizują, zaloguj się i używaj aplikacji przez minutę.
Jeśli docker compose pull zatrzymuje się z no space left on device, zazwyczaj przyczyną są stare warstwy obrazów, a usuwanie nieużywanych obrazów Docker odzyskuje miejsce. Wykonaj usuwanie po tym, jak aktualizacja potwierdzi swoje poprawne działanie, a nie przed, ponieważ te stare warstwy są tym, na czym opiera się szybkie wycofanie zmian.
Jak wycofać zmiany, gdy aktualizacja przebiegnie nieprawidłowo
Istnieją dwa przypadki, które wiążą się z różnymi kosztami. Jeśli nowa wersja nie zmieniła schematu, wycofanie zmian to jedna linia: przywróć stary tag w pliku compose i uruchom docker compose up -d. Kontener zostanie zastąpiony, wolumeny pozostaną na swoim miejscu, a stary kod odczyta dane, które zapisał.
Jeśli nowa wersja przeprowadziła migrację schematu, stary kod nie będzie już w stanie go odczytać. Migracje są pisane w celu uruchamiania w przód, a większość projektów nie dostarcza żadnego skryptu obniżającego wersję, więc stara wersja uruchamia się, a następnie zawodzi przy pierwszym zapytaniu do kolumny, która została zmieniona lub usunięta, z błędami typu ERROR: column "avatar_url" does not exist. Drogą powrotną jest zrzut wykonany przed pobraniem: przywróć stary tag, usuń wolumen bazy danych, odtwórz go jako pusty, przywróć zrzut i uruchom usługę. Bez tego zrzutu nie ma możliwości powrotu, co jest głównym powodem, dla którego kopię zapasową wykonuje się przed pobraniem.
Wersje główne Postgres są najbardziej krytycznym przypadkiem i zaskakują użytkowników, ponieważ awaria następuje podczas aktualizacji, a nie podczas wycofywania zmian. Wydania główne często zmieniają układ tabel systemowych, a każdy katalog danych jest oznaczony wersją główną, która go utworzyła, więc serwer z innej wersji głównej odmawia jego otwarcia, mimo że same pliki danych użytkownika rzadko zmieniają format. Zmień postgres:16.4 na postgres:17.2, uruchom docker compose up -d, a nowy serwer odmówi startu:
FATAL: database files are incompatible with server
DETAIL: The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.2.Obraz nie uruchamia pg_upgrade automatycznie. Najprostszą ścieżką wewnątrz stosu Compose jest: zrzut, zastąpienie, przywrócenie: wykonaj zrzut, gdy stara wersja jeszcze działa, docker compose down, usuń wolumen bazy danych, ustaw nowy tag, docker compose create dla uzyskania świeżego, pustego katalogu danych, uruchom bazę danych, przywróć zrzut, uruchom resztę. Jeśli nowy tag to 18 lub nowszy, przenieś również punkt montowania wolumenu: od PostgreSQL 18 oficjalny obraz przechowuje dane w katalogu specyficznym dla wersji, takim jak /var/lib/postgresql/18/docker, a jego wolumen to /var/lib/postgresql zamiast /var/lib/postgresql/data. Zachowaj stary zrzut, dopóki nowa wersja główna nie obsłuży rzeczywistego ruchu. Aktualizacje mniejsze wewnątrz jednej wersji głównej, na przykład z 16.4 do 16.9, nie wymagają żadnych z tych działań, ponieważ wydanie mniejsze nie wymaga zrzutu i przywracania, a kontener po prostu się uruchamia.
Czy snapshoty VPS to kopia zapasowa?
Stanowią one uzupełnienie kopii zapasowej, a oba rozwiązania zawodzą w różnych sytuacjach. Snapshot kopiuje cały dysk na poziomie hypervisora, dzięki czemu przywraca całą maszynę w kilka minut, włącznie z elementami, o których zapomniano podczas tworzenia kopii zapasowej. Jest to właściwe narzędzie do jednego konkretnego zadania: aktualizacja uszkodziła serwer i wymagany jest powrót do stanu sprzed dwudziestu minut.
W każdym innym przypadku jest to narzędzie mało efektywne. Granularność obejmuje całą maszynę, więc odzyskanie jednej usuniętej tabeli wymaga przywrócenia całego serwera w innym miejscu i wyodrębnienia z niego tej tabeli. Okres przechowywania jest zazwyczaj krótki. Kopie zazwyczaj znajdują się na tym samym koncie dostawcy co serwer, więc utrata dostępu do konta oznacza jednoczesną utratę serwera i jego snapshotów. Ponadto snapshot działającej maszyny rejestruje bazę danych w trakcie zapisu, co wymusza na niej przeprowadzenie procedury crash recovery przy pierwszym uruchomieniu, przez co wszystkie transakcje będące w toku zostają utracone.
Należy stosować oba rozwiązania. Snapshot to przycisk „cofnij” na czas okna aktualizacji. Zrzut bazy danych (dump) to kopia, która przetrwa utratę konta. różnice między snapshotami a kopiami zapasowymi szczegółowo omawia, przed jakimi awariami chroni każde z tych rozwiązań. Ten sam katalog z kopiami zapasowymi sprawia, że przenoszenie stosu na nowy VPS staje się rutynowym zadaniem, a nie odtwarzaniem konfiguracji z pamięci.
Co może pójść nie tak i co zobaczysz
Flaga volumes przy poleceniu down. docker compose down -v usuwa nazwane wolumeny zadeklarowane w pliku, a Compose potwierdza to komunikatem Volume myapp_db_data Removed. Operacja jest nieodwracalna. Zwykłe docker compose down pozostawia je bez zmian. Używaj pełnej formy docker compose down --volumes, aby wymusić świadome wpisanie niszczącej flagi.
Zrzut bez ciągu magicznego. pg_restore: error: did not find magic string in file header oznacza, że plik nie jest archiwum. Najczęstszą przyczyną jest brak -T przy docker compose exec, ponieważ przy podłączonym TTY strumień jest tłumaczony w drodze do powłoki, co uszkadza binarny zrzut. Wykonaj zrzut ponownie z -T, a następnie sprawdź pierwsze pięć bajtów za pomocą head -c 5.
Hasło, którego nie można zmienić. FATAL: password authentication failed for user "appuser" po przywróceniu danych oznacza, że .env oraz katalog danych pochodzą z różnych momentów. Obraz ustawia hasło tylko podczas tworzenia pustego katalogu danych, więc późniejsza edycja .env nie zmienia niczego wewnątrz bazy danych. Przywróć pasujący .env lub zmień hasło bezpośrednio w bazie danych za pomocą ALTER USER.
Drugi, pusty wolumen. Docker tworzy wolumen na żądanie, więc docker run -v myapp_upload:/data przy braku s zapisuje dane do zupełnie nowego, pustego wolumenu i zgłasza sukces. docker volume ls pokazuje wtedy obie nazwy, z których jedna jest pusta. Kopiuj nazwy wolumenów z docker volume ls zamiast wpisywać je z pamięci.
Przywracanie danych na środowisku produkcyjnym. Uruchomienie poleceń przywracania w /srv/myapp zamiast w /srv/myapp-restore nadpisuje bieżące dane kopią zapasową, a polecenia wyglądają identycznie w obu lokalizacjach. Sprawdź pwd przed każdym poleceniem przywracania i przechowuj procedury testowe w osobnym katalogu.
FAQ
Czy docker compose down usuwa moje dane?
Nie. docker compose down usuwa kontenery oraz domyślną sieć, pozostawiając nienaruszone wolumeny nazwane oraz bind mounts. docker compose down -v usuwa wolumeny nazwane zadeklarowane w pliku, co jest operacją nieodwracalną. Bind mounts to katalogi na hoście, więc Compose nigdy ich nie usuwa. Jeśli celem jest zatrzymanie usług na czas tworzenia kopii zapasowej bez naruszania pozostałych elementów, należy użyć docker compose stop.
Czy mogę skopiować katalog danych Postgres zamiast uruchamiać pg_dump?
Tylko przy zatrzymanym kontenerze. Gdy serwer działa, pliki zmieniają się w trakcie operacji, a kopia może zawierać niespójny stan, którego nie da się odtworzyć. Kopia na poziomie plików jest również powiązana z konkretną wersją główną Postgres, więc nie uruchomi się pod inną wersją. Należy zatrzymać kontener, zarchiwizować wolumen, uruchomić go ponownie i traktować wynik jako szybką ścieżkę odtwarzania, a nie jedyną kopię zapasową. Zrzut (dump) jest kopią przenośną i to z niego należy przywracać dane.
Jak zaktualizować Postgres do nowej wersji głównej w Compose?
Zmiana tagu nie wystarczy. Nowy serwer odmówi uruchomienia na starym katalogu danych i zarejestruje błąd The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.2. Należy wykonać pg_dump przy wciąż działającej starej wersji, następnie docker compose down, usunąć wolumen bazy danych, ustawić nowy tag, wykonać docker compose create w celu utworzenia nowego pustego wolumenu, uruchomić bazę danych i przywrócić do niej zrzut. Stary zrzut należy zachować do momentu, aż nowa wersja obsłuży rzeczywisty ruch.
Jak często wykonywać kopie zapasowe i jak długo je przechowywać?
Częstotliwość należy dostosować do ilości pracy, którą można zaakceptować do ponownego wykonania. Kopie nocne są odpowiednie dla stosów osobistych lub małych zespołów, dodatkowo należy wykonać jedną ręczną kopię bezpośrednio przed każdą aktualizacją. W zakresie retencji należy przechowywać wystarczającą historię, aby uwzględnić uszkodzenia, których nie zauważono od razu, ponieważ uszkodzona tabela wykryta w piątek nie zostanie naprawiona kopią z czwartku wieczorem. restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune stanowi rozsądną politykę początkową. Niezależnie od harmonogramu, należy raz na kwartał przeprowadzić próbne przywracanie danych. Dopóki tego nie zrobisz, nie masz kopii zapasowych, a jedynie pliki.
Czy muszę zatrzymywać cały stos, aby wykonać kopię zapasową?
Zazwyczaj nie. Zrzut bazy danych jest spójny podczas pracy serwera, więc baza nie wymaga przestoju. Kwestią pozostają wolumeny. Jeśli aplikacja tylko dodaje pliki, na przykład w katalogu przesyłania, archiwizacja w czasie pracy jest wystarczająco bezpieczna. Jeśli aplikacja nadpisuje pliki w miejscu, należy zatrzymać tę konkretną usługę na czas kopiowania za pomocą docker compose stop app, a następnie uruchomić ją ponownie. Zatrzymanie aplikacji przy działającej bazie danych jest zazwyczaj najkrótszym bezpiecznym oknem serwisowym, jakie można zorganizować.