SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor · Zaktualizowano 2026-10-23

Baza danych w Docker czy na hoście: co wybrać?

Analiza wdrożeń PostgreSQL, MySQL i Redis w kontenerach. Dowiedz się, jak zarządzać wolumenami, aktualizacjami i kopiami zapasowymi, aby uniknąć błędów w środowisku produkcyjnym.

Czy baza danych powinna działać w Docker czy na hoście?

Bazę danych należy uruchamiać w Docker. W przypadku pojedynczego stosu aplikacji na jednym VPS, konteneryzowany PostgreSQL, MySQL, MongoDB lub Redis jest standardowym rozwiązaniem produkcyjnym, a dyskusje na ten temat zazwyczaj koncentrują się na niewłaściwych argumentach. Kontener to proces systemu Linux z nałożonymi przestrzeniami nazw (namespaces) i grupami kontrolnymi (cgroups), a nie maszyna wirtualna, więc między bazą danych a dyskiem nie występuje żaden hypervisor. Dzięki bind mount lub lokalnemu wolumenowi nazwanemu, operacje odczytu i zapisu trafiają bezpośrednio na system plików hosta, czyli ten sam, z którego korzystałaby instalacja pakietowa.

Rzeczywisty koszt ma charakter operacyjny. O tym, czy taka konfiguracja jest poprawna, czy stanie się źródłem problemów, decydują cztery kwestie: lokalizacja danych, właściciel katalogu, przebieg aktualizacji głównej wersji oraz fakt, czy kiedykolwiek przywracano kopię zapasową. Jeśli te elementy zostaną poprawnie skonfigurowane, kontener staje się jedynie szczegółem technicznym. W przeciwnym razie kontener będzie pierwszym elementem, który zostanie obarczony winą za awarię.

Decyzja ta wygląda identycznie dla każdej bazy danych na serwerze. Poniższe przykłady wykorzystują PostgreSQL, MySQL, MongoDB oraz Redis, a różnice specyficzne dla danego produktu zostały wskazane tam, gdzie mają znaczenie.

Co faktycznie zmienia kontener

Nie ścieżka zapisu, o ile zamontowano wolumen. Ten sam kernel, ta sama pamięć podręczna stron (page cache), ten sam system plików.

Istnieje jedna realna pułapka wydajnościowa: sytuacja, w której nie montuje się niczego. Bez wolumenu katalog danych trafia do warstwy zapisu kontenera, czyli systemu plików overlay nałożonego na obraz. Zapisy w tym miejscu są wolniejsze, a cała warstwa jest usuwana wraz z usunięciem kontenera. Stąd biorą się przypadki typu „moja baza danych była rano pusta”.

Co zmienia się faktycznie:

  • Cykl życia. docker compose down niszczy kontener. Wszystko, co nie znajdowało się w wolumenie, przepada wraz z nim.
  • Wersja. Tag obrazu to wersja. Wewnątrz kontenera bazy danych nie ma żadnego apt upgrade, który przetrwałby kolejny docker compose pull.
  • Rozliczanie pamięci. Limit cgroup to twarda bariera wymuszana przez kernel, a większość baz danych nie dostosowuje swoich ustawień domyślnych do tego ograniczenia. MySQL 9.3 lub nowszy odczytuje ten limit dla niektórych parametrów. MongoDB próbuje to robić dla swojej pamięci podręcznej WiredTiger, ale własna dokumentacja ostrzega, że w niektórych przypadkach może to nie zadziałać. PostgreSQL i Redis tego nie robią.
  • Użytkownik. Proces działa jako numeryczny identyfikator użytkownika (UID) wewnątrz kontenera, który może nie posiadać żadnych uprawnień do plików na hoście.

Lokalizacja danych determinuje wszystko

Istnieją dwie poprawne opcje oraz jeden powszechny błąd.

  • Wolumen nazwany: pgdata:/var/lib/postgresql/data. Docker tworzy katalog w /var/lib/docker/volumes/<project>_pgdata/_data, a punkt wejścia obrazu ustawia uprawnienia przy pierwszym uruchomieniu. Jest to zalecane rozwiązanie.
  • Montowanie typu bind mount: /srv/appname/pg:/var/lib/postgresql/data. Użytkownik wybiera ścieżkę, więc sam odpowiada za kwestię uprawnień.
  • Brak montowania. Patrz wyżej. Dane znajdują się wewnątrz kontenera.

Pełne zestawienie wad i zalet to osobny temat, który omawia bind mounts a wolumeny nazwane. W przypadku bazy danych skrócona wersja brzmi: należy używać wolumenu nazwanego, chyba że istnieje konkretny powód, by znać ścieżkę na hoście. Jeśli stosowane jest montowanie typu bind mount, należy umieścić je w stabilnym miejscu, takim jak /srv/appname/pg, zamiast wewnątrz katalogu projektu, gdzie może uzyskać do niego dostęp git clean.

Należy zachować ostrożność w przypadku pamięci sieciowej. Nie należy umieszczać katalogu danych bazy danych na NFS (network file system) ani żadnym innym zasobie sieciowym, którego zachowanie w zakresie blokowania i fsync nie zostało przetestowane. PostgreSQL dokumentuje jeden twardy wymóg dla NFS: montowanie z użyciem opcji hard oraz zdecydowanie zaleca opcję eksportu sync na serwerze NFS. Bez tego fsync na kliencie nie gwarantuje dotarcia danych do dysku serwera. Bazy danych zakładają, że pomyślne wykonanie fsync oznacza, iż bajty znajdują się na trwałym nośniku. Gdy to założenie jest błędne, dochodzi do uszkodzeń danych, które ujawniają się po tygodniach.

Przypisanie nazwy wolumenu przed jego utratą

Compose nadaje wolumenowi nazwę <project>_<volume>, a nazwa projektu domyślnie pochodzi od nazwy katalogu. Tożsamość wolumenu zależy zatem od nazwy katalogu, co jest parametrem często zmienianym bez głębszego zastanowienia.

Przeniesienie /srv/app do /srv/app-old lub zmiana nazwy klucza pgdata w pliku compose spowoduje, że kolejne polecenie docker compose up -d utworzy zupełnie nowy, pusty wolumen. Postgres zainicjuje w nim świeży klaster. Kontener będzie w stanie healthy, aplikacja wystartuje, a wszystkie tabele znikną. Dobrą wiadomością jest to, że stary wolumen nadal znajduje się na dysku pod starą nazwą.

docker volume ls
docker volume inspect app_pgdata

Przypisz nazwy na sztywno, aby zapobiec takiej sytuacji. Zdefiniuj jawnie nazwę projektu oraz nazwę wolumenu:

name: myapp

services:
  db:
    image: postgres:17
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:
    name: myapp_pgdata

Jeśli dane znajdują się w porzuconym wolumenie, skopiuj je po zatrzymaniu bazy danych:

docker compose stop db
docker run --rm -v app_pgdata:/from -v myapp_pgdata:/to alpine sh -c 'cp -a /from/. /to/'
docker compose start db

Kopiowanie w trakcie działania bazy danych prowadzi do powstania niespójnej kopii plików, które były w tym czasie zapisywane. Najpierw zatrzymaj usługę.

Kto jest właścicielem katalogu danych

Oficjalne obrazy Postgres, MySQL oraz MongoDB uruchamiają serwer jako nieuprzywilejowany użytkownik o numerycznym identyfikatorze 999 w domyślnych tagach oraz 70 w tagach Postgres -alpine. Gdy kontener startuje jako root, punkt wejścia (entrypoint) zmienia właściciela katalogu danych na tego użytkownika, a następnie porzuca uprawnienia. Dlatego puste dowiązanie (bind mount) zazwyczaj działa przy pierwszej próbie.

Mechanizm ten przestaje działać w momencie ustawienia user: w pliku compose, ponieważ punkt wejścia nie posiada wówczas uprawnień niezbędnych do wprowadzenia zmian. Postgres informuje o tym bezpośrednio:

initdb: error: could not change permissions of directory "/var/lib/postgresql/data": Operation not permitted

Katalog danych, który istnieje z nieprawidłowymi uprawnieniami, generuje inny komunikat. Warto go rozpoznać, ponieważ rozwiązaniem jest chmod, a nie chown:

FATAL:  data directory "/var/lib/postgresql/data" has invalid permissions
DETAIL:  Permissions should be u=rwx (0700) or u=rwx,g=rx (0750).

Punkt wejścia MongoDB naprawia własność w ten sam sposób, więc ten błąd pliku blokady oznacza, że operacja się nie powiodła: zazwyczaj ustawiono user: lub punkt montowania odrzuca operację chown wykonywaną przez root:

Unable to create/open the lock file: /data/db/mongod.lock (Permission denied). Ensure the user executing mongod is the owner of the lock file and has the appropriate permissions.

Rozwiązaniem jest wykonanie chown na katalogu hosta z użyciem identyfikatora numerycznego, a nie nazwy:

sudo chown -R 999:999 /srv/appname/pg
sudo chmod 700 /srv/appname/pg
ls -ldn /srv/appname/pg

ls -ldn wyświetla numery zamiast nazw i powinno wskazywać 999 999. Dla obrazu Postgres -alpine należy użyć 70:70 i oczekiwać 70 70. Konto o nazwie postgres na hoście oraz konto o nazwie postgres wewnątrz obrazu nie są ze sobą powiązane: jądro systemu porównuje numery, a nazwy są sprawdzane oddzielnie po każdej ze stron. w jaki sposób PUID i PGID mapują użytkowników hosta do kontenera szczegółowo opisuje to mapowanie. W przypadku rootless Docker lub remapowania przestrzeni nazw użytkownika (user namespace remapping) numery ulegają zmianie, dlatego należy odczytać identyfikatory z uruchomionego kontenera, zamiast zakładać wartość 999.

Wolumeny nazwane (named volumes) sprawiają, że problem opisany w tej sekcji znika przy pierwszym uruchomieniu, ponieważ Docker tworzy pusty katalog, a punkt wejścia przejmuje nad nim własność.

Aktualizacje: zmiana wersji pakietu poprzez zmianę tagu obrazu

Na hoście polecenie apt upgrade pozwala na przejście do kolejnej wersji mniejszej. Dystrybucja nie dokona automatycznego przejścia na nową wersję główną bazy danych. Gdy zdecydujesz się na taką aktualizację, oba zestawy plików binarnych mogą być zainstalowane jednocześnie, co jest dokładnie tym, czego wymaga pg_upgrade.

W kontenerze tag oznacza wersję, więc aktualizacja sprowadza się do edycji jednej linii. Dzięki temu aktualizacje wersji mniejszych są trywialne, a aktualizacje wersji głównych stają się ustandaryzowaną procedurą.

Zmień postgres:16 na postgres:17 i uruchom docker compose up -d, a kontener natychmiast zakończy działanie:

PostgreSQL Database directory appears to contain a database; Skipping initialization
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.

Nic nie ulega uszkodzeniu. Nowe pliki binarne odmawiają odczytu starego układu katalogów na dysku, który zmienia się między wersjami głównymi. Przywróć tag postgres:16, a usługa ponownie się uruchomi. Taka możliwość wycofania zmian to jedyna rzeczywista przewaga aktualizacji w kontenerach.

Wspierana ścieżka to zrzut i przywracanie danych. PostgreSQL preferuje, aby zrzut był wykonany przez nowszego klienta, dlatego należy uruchomić go z nowego obrazu przeciwko wciąż działającemu staremu serwerowi w sieci compose:

docker run --rm --network myapp_default -e PGPASSWORD="$POSTGRES_PASSWORD" \
  postgres:17 pg_dumpall -h db -U postgres > /srv/backups/all.sql
ls -lh /srv/backups/all.sql
tail -n 2 /srv/backups/all.sql

Plik powinien mieć co najmniej kilkadziesiąt kilobajtów i kończyć się linią PostgreSQL database cluster dump complete. Plik o rozmiarze kilkuset bajtów oznacza, że zrzut nie powiódł się i usunięcie wolumenu byłoby bezcelowe. Dopiero po sprawdzeniu tego wykonaj:

docker compose down
docker volume rm myapp_pgdata
# edit the compose file: image: postgres:17
docker compose up -d db
docker compose exec -T db psql -U postgres -f /dev/stdin < /srv/backups/all.sql

Zaplanuj jeszcze jedną zmianę w postgres:18. Od wersji 18 oficjalny obraz przechowuje dane w katalogu z wersją wewnątrz /var/lib/postgresql (dla wersji 18 jest to /var/lib/postgresql/18/docker) i deklaruje swój wolumen w /var/lib/postgresql. Wolumen wciąż zamontowany w /var/lib/postgresql/data spowoduje, że kontener zakończy działanie z błędem zaczynającym się od Error: in 18+, these Docker images are configured to store database data. Przechodząc na wersję 18 lub nowszą, zmień punkt montowania na pgdata:/var/lib/postgresql. Ścieżki /var/lib/postgresql/data w tym wpisie dotyczą wersji 17 i starszych.

Inne silniki działają inaczej:

  • MySQL 8 aktualizuje własny słownik danych przy starcie, więc zmiana tagu wersji mniejszej to zazwyczaj tylko restart. Przed przejściem między seriami wydań przeczytaj informacje o wersji i w każdym przypadku wykonaj zrzut danych.
  • MariaDB wymaga uruchomienia mariadb-upgrade po tym, jak serwer zostanie uruchomiony w nowej wersji.
  • MongoDB musi być aktualizowane o jedną wersję główną na raz. Po każdym kroku należy ustawić wersję kompatybilności funkcji przed przejściem dalej. Pominięcie wersji spowoduje, że mongod odmówi startu i zapisze w logach UPGRADE PROBLEM z informacją featureCompatibilityVersion. Od wersji MongoDB 7.0 polecenie wymaga jawnej flagi potwierdzenia: db.adminCommand({ setFeatureCompatibilityVersion: "8.0", confirm: true }).
  • Redis bez problemu wczytuje starsze pliki migawek, ale nie nowsze, więc aktualizacja to restart, a przy próbie przywrócenia starszej wersji wczytanie danych może się nie udać.

Ogólna zasada: kontener ułatwia wycofanie zmian, ale nie ułatwia samej aktualizacji.

Dlaczego mój kontener z bazą danych kończy działanie z kodem 137?

Dzieje się tak, ponieważ mechanizm OOM (Out of Memory) killera jądra systemu przerwał jego pracę. Kod 137 to suma 128 oraz sygnału 9.

docker compose ps --all
docker inspect myapp-db-1 | grep -i oomkilled
journalctl -k | tail -n 20

docker compose ps --all pokazuje Exited (137). Bez --all, Compose wyświetla tylko uruchomione kontenery, więc nieaktywna baza danych jest po prostu pomijana w wynikach. Polecenie inspect zwraca "OOMKilled": true, a dziennik jądra zawiera odpowiadający mu wpis:

Memory cgroup out of memory: Killed process 4711 (postgres) total-vm:2170416kB

OOMKilled informuje jedynie, że OOM killer zakończył proces wewnątrz kontenera. Prefiks Memory cgroup out of memory wskazuje, że przyczyną było przekroczenie limitu samego kontenera. Niedobór pamięci w skali całego hosta powoduje zapisanie w logach Out of memory: Killed process; w takim przypadku rozwiązanie problemu leży po stronie hosta, a nie kontenera.

Mechanizm ten często zaskakuje użytkowników. Wewnątrz kontenera free oraz /proc/meminfo nadal raportują całkowitą ilość pamięci hosta, a limit cgroup nie zmienia tej wartości. PostgreSQL nie dostosowuje do niej automatycznie swoich parametrów: shared_buffers domyślnie wynosi 128MB, a każda wyższa wartość jest wynikiem wyboru użytkownika lub poradnika optymalizacji. Parametr innodb_buffer_pool_size w MySQL również domyślnie wynosi 128M. Problemy pojawiają się, gdy ustawienia są dobierane na podstawie wartości raportowanych przez system. Dokumentacja PostgreSQL sugeruje ustawienie shared_buffers na poziomie 25% pamięci systemowej. Na hoście z 16 GB RAM i limitem 2 GB dla kontenera, ta zasada sugeruje 4 GB, co powoduje, że cgroup przerywa działanie bazy danych na długo przed wystąpieniem jakiegokolwiek obciążenia samego hosta. Niektóre silniki bazodanowe potrafią już odczytać limity kontenera dla niektórych wartości domyślnych: MySQL 9.3 i nowsze wersje to robią, a MongoDB wykorzystuje tę informację dla pamięci podręcznej WiredTiger, o ile uda się ją wykryć. Żaden z nich nie opiera jednak wszystkich ustawień na tym limicie, a dokumentacja MongoDB ostrzega, że wykrywanie może zawieść. Sam limit pamięci nie wystarcza. Należy jawnie określić zasoby dostępne dla bazy danych:

  • PostgreSQL: ustaw shared_buffers i zwróć uwagę na work_mem. work_mem dotyczy każdej operacji sortowania lub haszowania, a każde połączenie może wykonywać ich kilka jednocześnie. Zbyt wysoka wartość przy pięćdziesięciu połączeniach jest najczęstszą przyczyną wyłączania się kontenera pod obciążeniem, zamiast podczas startu.
  • MySQL i MariaDB: ustaw innodb_buffer_pool_size, którego wartość domyślna to 128M. W wersjach MySQL starszych niż 9.3 pozostaw innodb_dedicated_server wyłączone w kontenerze, ponieważ parametr ten ustala rozmiar puli buforów na podstawie pamięci maszyny, co w tym przypadku oznacza pamięć hosta. Od wersji 9.3 MySQL odczytuje limity kontenera i innodb_dedicated_server dostosowuje się do nich, jednak jawne określenie rozmiaru puli buforów pozostaje rozwiązaniem przewidywalnym.
  • MongoDB: ustaw rozmiar pamięci podręcznej WiredTiger jawnie. MongoDB korzysta z limitu kontenera, jeśli potrafi go wykryć (hostInfo raportuje to jako memLimitMB), ale dokumentacja ostrzega, że w niektórych przypadkach może to zawieść i zaleca ustawienie --wiredTigerCacheSizeGB lub --wiredTigerCacheSizePct poniżej limitu pamięci kontenera.
  • Redis: maxmemory domyślnie jest nieograniczone, więc Redis rośnie, dopóki cgroup go nie zatrzyma. Ustaw maxmemory na wartość bezpiecznie poniżej limitu kontenera i wybierz odpowiednią maxmemory-policy.

Postgres również raportuje to zdarzenie po swojej stronie; w logach znajdziesz następującą parę linii:

LOG:  server process (PID 123) was terminated by signal 9: Killed
LOG:  terminating any other active sessions due to crash of another server process

Przerwanie pracy jednego backendu wymusza restart wszystkich pozostałych, ponieważ pamięć współdzielona może być teraz niespójna. Dla aplikacji oznacza to gwałtowny wzrost liczby połączeń, a nie ciche zdarzenie. ustawianie limitów pamięci w Docker Compose omawia składnię oraz różnicę między mem_limit a formą deploy.resources.

Problem ten nie znika na hoście, lecz zmienia swoje miejsce. Bez cgroup baza danych konkuruje o zasoby ze wszystkimi innymi procesami, a OOM killer hosta wybiera ofiarę na podstawie punktacji, którą może być nawet sshd. Limit, który w przewidywalny sposób wyłącza bazę danych, jest łatwiejszy w obsłudze niż OOM kill hosta, który może zablokować dostęp do systemu.

Kopie zapasowe: zrzut wewnątrz, kopia na zewnątrz

Nie należy tworzyć kopii zapasowej działającej bazy danych poprzez kopiowanie jej katalogu z danymi. Kopia na poziomie plików wykonana w trakcie zapisu przez serwer jest kopią niespójną, co ujawnia się dopiero w momencie przywracania danych.

Istnieją dwie poprawne metody: wykonanie zrzutu za pomocą wbudowanego narzędzia bazy danych podczas jej pracy i zabezpieczenie tego zrzutu lub zatrzymanie kontenera i wykonanie kopii wolumenu w trybie "na zimno".

docker compose exec -T db pg_dump -U postgres -Fc appdb > /srv/backups/appdb.dump
docker compose exec -T db mysqldump -u root -p"$MYSQL_ROOT_PASSWORD" --single-transaction --all-databases > /srv/backups/mysql.sql
docker compose exec -T db mongodump --archive --gzip --db appdb > /srv/backups/appdb.archive.gz
docker compose exec -T redis redis-cli BGSAVE

Flaga -T jest kluczowa. Bez niej docker compose exec może podpiąć terminal do polecenia, co spowoduje dodanie znaków powrotu karetki do strumienia wyjściowego. Zrzut tekstowy przywróci się wtedy z błędami, a zrzut binarny będzie po prostu uszkodzony. Proces ten kończy się niepowodzeniem w sposób cichy podczas tworzenia kopii, a w sposób głośny miesiąc później.

Opcja --single-transaction zapewnia mysqldump spójną migawkę tabel InnoDB bez blokowania całego serwera.

Powyższe polecenia tworzą pojedyncze pliki. Nie stanowią one systemu kopii zapasowych: brakuje w nich retencji, kopiowania poza serwer oraz weryfikacji. Katalog ze zrzutami należy przekazać narzędziu, które realizuje wszystkie trzy funkcje, co opisano w restic backups from a VPS. Należy tworzyć kopie zapasowe /srv/backups, a nie /var/lib/docker/volumes.

Następnie należy przeprowadzić procedurę przywracania, ponieważ kopia, której nigdy nie przywrócono, nie jest kopią zapasową:

docker compose exec -T db createdb -U postgres restore_test
docker compose exec -T db pg_restore -U postgres -d restore_test < /srv/backups/appdb.dump
docker compose exec -T db psql -U postgres -d restore_test -c '\dt'

Polecenie \dt powinno wyświetlić tabele aplikacji. Pusty wynik lub Did not find any relations. oznacza, że zrzut nie zawiera oczekiwanych danych. Po zakończeniu pracy należy usunąć restore_test.

Polecenie usuwające wszystko

docker compose down -v.

Zwykłe down usuwa kontenery oraz sieć. Polecenie -v usuwa również każdy wolumen nazwany zadeklarowany w pliku compose, a także wszystkie wolumeny anonimowe podpięte do tych kontenerów. Operacja nie wyświetla monitu o potwierdzenie i nie można jej cofnąć. Jest to najczęstsza przyczyna utraty danych w bazach danych hostowanych samodzielnie; zazwyczaj dochodzi do tego podczas rozwiązywania niezwiązanych z tym problemów, gdy użytkownik wykonuje polecenie zasugerowane na forum.

Cztery zasady ograniczają zakres potencjalnych szkód:

  • Deklaruj wolumeny baz danych jako external: true. Compose nie usuwa wolumenów, którymi nie zarządza, więc -v nie będzie w stanie ich usunąć. Wolumen tworzy się jednorazowo za pomocą docker volume create myapp_pgdata.
  • Używaj docker compose stop oraz docker compose start do rutynowych restartów. down kontra stop w Compose wyjaśnia, co usuwa każde z tych poleceń.
  • Przechowuj zrzuty baz danych w ścieżce na hoście, poza wolumenami zarządzanymi przez compose.
  • Nigdy nie wklejaj -v z odpowiedzi na forum do stosu zawierającego ważne dane.

Nie publikuj portu bazy danych

Poniższa linia udostępnia bazę danych w publicznym Internecie:

    ports:
      - "5432:5432"

Powoduje ona powiązanie z każdym interfejsem sieciowym. Docker publikuje port poprzez nadpisanie miejsca docelowego pakietu, zanim reguły wejściowe firewalla zdążą go przetworzyć. Reguły ufw znajdują się w łańcuchu input, dlatego ufw deny 5432 nie przynosi żadnego efektu. dlaczego publikowane porty Dockera omijają ufw przedstawia sposób przechodzenia pakietów przez łańcuchy.

Aplikacja w tym samym projekcie compose uzyskuje dostęp do bazy danych za pomocą nazwy usługi w sieci compose, więc nie wymaga publikowania portu. Usuń ten blok. Jeśli potrzebujesz dostępu dla klienta na hoście, powiąż usługę wyłącznie z interfejsem loopback:

    ports:
      - "127.0.0.1:5432:5432"

Sprawdź, co faktycznie nasłuchuje na portach:

sudo ss -ltnp | grep 5432

127.0.0.1:5432 to pożądany stan. 0.0.0.0:5432 oznacza, że każdy może podjąć próbę odgadnięcia hasła.

Co i gdzie uruchamiać

Jedna aplikacja na jednym VPS. Kontener. Nazwany wolumen z przypisaną nazwą, bez wystawionego portu, z limitem pamięci dopasowanym do ustawień bazy danych oraz nocnym zrzutem do ścieżki na hoście, z której dane pobiera restic. Zacznij od czystej instalacji Docker na VPS i utrzymuj stos w jednym pliku compose, który zatwierdzasz w repozytorium. Zysk jest wymierny: wersja bazy danych staje się możliwą do przejrzenia linią w git.

Host uruchamiający kilka usług. Kontenery, jedna baza danych na aplikację, a nie jeden współdzielony serwer dla wszystkich. Współdzielony serwer wiąże każdą aplikację z jednym harmonogramem aktualizacji, a jedno zapytanie powodujące przeciążenie staje się awarią dla wszystkich. Przypisz każdemu kontenerowi własny limit pamięci, aby błędne zapytanie było ograniczone do aplikacji, która je wygenerowała. Kilka małych instancji Postgres kosztuje nieco więcej miejsca na dysku, ale wymaga znacznie mniej koordynacji.

Baza danych jest produktem. Uruchom ją na hoście z repozytorium pakietów dostawcy lub skorzystaj z płatnej usługi zarządzanej. pg_upgrade wymaga jednoczesnej instalacji obu głównych wersji plików binarnych, co zapewniają pakiety, a czego nie oferuje obraz z jedną wersją. Replikacja oraz odzyskiwanie do punktu w czasie (PITR) z archiwizacją WAL (write ahead log) są łatwiejsze, gdy baza danych posiada pełną kontrolę nad maszyną i jej dyskami. Wybierz przewidywalną ścieżkę dla systemu, który będzie wysyłał powiadomienia o awarii o 03:00.

Aplikacja jest mała. Rozważ rezygnację z serwerowej bazy danych. Aplikacja internetowa z jednym zapisującym procesem na jednym VPS często lepiej działa z SQLite w środowisku produkcyjnym na VPS, gdzie kopia zapasowa to jeden plik, a ścieżka aktualizacji ogranicza się do wersji biblioteki.

FAQ

Czy uruchamianie produkcyjnej bazy danych w Docker jest bezpieczne?

Tak, w przypadku stosu aplikacji na pojedynczym serwerze. Kontener to proces Linux z nałożonymi przestrzeniami nazw (namespaces) i cgroups, więc przy zamontowanym wolumenie baza danych zapisuje dane w tym samym systemie plików hosta, co w przypadku instalacji z pakietu. Ryzyko ma charakter operacyjny, a nie wydajnościowy: wolumen o nieprzypisanej nazwie, bind mount z niewłaściwym właścicielem, nieprzetestowana procedura przywracania danych oraz docker compose down -v. Wyeliminowanie tych czterech czynników sprawia, że kontener jest bezpieczny. Przejdź na instalację bezpośrednio na hoście, gdy baza danych stanowi główne obciążenie i wymagane są pg_upgrade, replikacja lub odtwarzanie do punktu w czasie (point in time recovery).

Czy do danych bazy danych użyć bind mount czy nazwanego wolumenu?

Używaj nazwanego wolumenu, chyba że istnieje konkretny powód, by znać ścieżkę na hoście. Docker tworzy katalog, a punkt wejścia (entrypoint) obrazu ustawia uprawnienia przy pierwszym uruchomieniu, dzięki czemu problem z dostępem nie występuje. Przypnij wolumen za pomocą jawnego name: lub oznacz go jako external: true, w przeciwnym razie zmiana nazwy katalogu projektu spowoduje ciche utworzenie nowego, pustego wolumenu i pustej bazy danych. Bind mount jest dopuszczalny, jeśli zmienisz właściciela katalogu na hoście (chown) na numeryczny identyfikator użytkownika (UID), z którego korzysta obraz – jest to 999 dla domyślnych tagów oficjalnych obrazów Postgres, MySQL i MongoDB oraz 70 dla tagów -alpine Postgres. Zweryfikuj to za pomocą ls -ldn, ponieważ ls -l wyświetla nazwę użytkownika z hosta dla tego numeru, a ta nazwa nie ma znaczenia wewnątrz kontenera.

Co usuwa docker compose down -v?

Usuwa kontenery i sieć podobnie jak zwykłe down, a -v dodatkowo usuwa każdy nazwany wolumen zadeklarowany w pliku compose oraz każdy anonimowy wolumen podpięty do tych kontenerów. Dotyczy to również bazy danych. Nie ma monitu o potwierdzenie ani możliwości odzyskania danych. Wolumeny oznaczone jako external: true nie są usuwane, co jest głównym powodem oznaczania wolumenu bazy danych jako zewnętrzny. Do rutynowego restartu używaj docker compose stop oraz docker compose start.

Jak zaktualizować PostgreSQL do nowej wersji głównej w Docker?

Wykonaj zrzut (dump) i przywrócenie. Zmiana postgres:16 na postgres:17 i restart spowoduje FATAL: database files are incompatible with server z linią DETAIL wskazującą obie wersje, ponieważ nowe pliki binarne nie odczytają starego układu katalogów. Nic nie ulega uszkodzeniu: przywróć stary tag, a usługa wystartuje. Wykonaj pg_dumpall przy użyciu klienta nowej wersji przeciwko działającemu staremu kontenerowi, upewnij się, że plik kończy się na PostgreSQL database cluster dump complete, a następnie uruchom nowy tag na pustym wolumenie i wczytaj zrzut. Od wersji postgres:18 montuj ten wolumen w /var/lib/postgresql zamiast w /var/lib/postgresql/data. Mniejsze aktualizacje w ramach jednej wersji głównej wymagają jedynie pull i restartu.

Dlaczego mój kontener z bazą danych kończy działanie z kodem 137?

137 to 128 plus sygnał 9, co oznacza, że proces został natychmiastowo zabity. Uruchom docker inspect <container> | grep -i oomkilled; wartość true oznacza, że mechanizm OOM killer zakończył proces w kontenerze, zazwyczaj z powodu osiągnięcia limitu pamięci cgroup. Częstą przyczyną są ustawienia pamięci dostosowane do hosta, a nie do kontenera: narzędzia wewnątrz kontenera nadal raportują całkowitą pamięć hosta, więc bufor ustawiony na 16 GB próbuje działać w ramach 2 GB. Ustaw shared_buffers i work_mem lub innodb_buffer_pool_size, aby dopasować je do limitu nadanego kontenerowi. Sprawdź journalctl -k pod kątem pasującej linii Memory cgroup out of memory, aby potwierdzić, który proces został wybrany przez jądro i czy był to limit kontenera, a nie zabicie procesu przez Out of memory na poziomie całego hosta.

Czy ten artykuł był przydatny?