SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor · Aktualisiert 2026-10-22

Datenbank in Docker oder auf dem Host betreiben?

PostgreSQL, MySQL, MongoDB und Redis laufen produktiv problemlos in Docker. Entscheidend sind Volumes, Upgrades, Backups und harte Speicherlimits.

Soll die Datenbank in Docker oder auf dem Host laufen?

Betreiben Sie die Datenbank in Docker. Für einen Anwendungsstack auf einem VPS ist ein containerisiertes PostgreSQL, MySQL, MongoDB oder Redis eine übliche Wahl für den Produktivbetrieb. Die Diskussion darüber basiert meist auf dem falschen Argument. Ein Container ist ein Linux-Prozess mit Namespaces und cgroups. Er ist keine virtuelle Maschine. Zwischen der Datenbank und dem Datenträger befindet sich daher kein Hypervisor. Bei einem Bind-Mount oder einem lokalen benannten Volume landen Lese- und Schreibvorgänge im Dateisystem des Hosts. Es ist dasselbe Dateisystem, das auch eine Paketinstallation verwenden würde.

Die tatsächlichen Kosten entstehen im Betrieb. Vier Punkte entscheiden darüber, ob dieses Setup problemlos funktioniert oder zu einem langsamen Desaster wird: Wo liegen die Daten? Wem gehört das Verzeichnis? Wie sieht ein Upgrade auf eine neue Hauptversion aus? Und haben Sie jemals ein Backup wiederhergestellt? Wenn diese Punkte geklärt sind, ist der Container nur ein Detail. Wenn nicht, werden Sie dem Container die Probleme zuschreiben.

Diese Entscheidung ist bei jeder Serverdatenbank dieselbe. Die folgenden Beispiele verwenden PostgreSQL, MySQL, MongoDB und Redis. Die produktspezifischen Unterschiede werden an den relevanten Stellen erläutert.

Was sich durch einen Container tatsächlich ändert

Nicht der Speicherpfad, solange Sie einen einbinden. Es werden derselbe Kernel, derselbe Page Cache und dasselbe Dateisystem verwendet.

Es gibt eine echte Performance-Falle: Sie binden kein Volume ein. Ohne Volume liegt das Datenverzeichnis in der beschreibbaren Schicht des Containers. Diese basiert auf einem Overlay-Dateisystem über dem Image. Schreibvorgänge sind dort langsamer. Außerdem wird die gesamte Schicht gelöscht, wenn Sie den Container entfernen. Daher stammt die Meldung: „Meine Datenbank war heute Morgen leer.“

Tatsächlich ändern sich folgende Punkte:

  • Der Lebenszyklus. docker compose down löscht den Container. Alles, was nicht in einem Volume lag, wird dabei ebenfalls gelöscht.
  • Die Version. Der Image-Tag bestimmt die Version. In einem Datenbank-Container gibt es kein apt upgrade, das den nächsten docker compose pull übersteht.
  • Die Speicherabrechnung. Ein cgroup-Limit ist eine vom Kernel erzwungene harte Grenze. Die meisten Standardkonfigurationen von Datenbanken passen ihre Speichergröße nicht automatisch daran an. MySQL 9.3 oder höher berücksichtigt das Limit bei einigen Einstellungen. MongoDB versucht dies für seinen WiredTiger-Cache, weist in der eigenen Dokumentation jedoch darauf hin, dass dies in manchen Fällen nicht geschieht. PostgreSQL und Redis tun dies nicht.
  • Der Benutzer. Der Prozess läuft im Container unter einer numerischen Benutzer-ID. Dieser Benutzer besitzt auf dem Host möglicherweise keine Dateien.

Wo die Daten liegen, entscheidet alles

Es gibt zwei gute Optionen und einen häufigen Fehler.

  • Ein benanntes Volume: pgdata:/var/lib/postgresql/data. Docker erstellt das Verzeichnis unter /var/lib/docker/volumes/<project>_pgdata/_data, und der Image-Entrypoint setzt beim ersten Start den Eigentümer. Das ist die Standardempfehlung.
  • Ein Bind-Mount: /srv/appname/pg:/var/lib/postgresql/data. Sie wählen den Pfad selbst und sind daher für die Berechtigungen verantwortlich.
  • Überhaupt kein Mount. Siehe oben. Die Daten liegen im Container.

Die vollständige Abwägung ist ein eigenes Thema. Bind-Mounts im Vergleich zu benannten Volumes behandelt sie. Für eine Datenbank gilt kurz gesagt: Verwenden Sie ein benanntes Volume, sofern es keinen konkreten Grund gibt, den Pfad auf dem Host zu kennen. Wenn Sie einen Bind-Mount verwenden, legen Sie ihn an einem stabilen Ort wie /srv/appname/pg ab und nicht innerhalb des Projektverzeichnisses, wo ein git clean darauf zugreifen kann.

Seien Sie bei Netzwerkspeicher vorsichtig. Legen Sie ein Datenverzeichnis einer Datenbank nicht auf NFS (Network File System) oder einen anderen Netzwerk-Mount, dessen Sperr- und fsync-Verhalten Sie nicht getestet haben. PostgreSQL dokumentiert für NFS eine zwingende Anforderung: Der Mount muss die Option hard verwenden. Außerdem wird die Exportoption sync auf dem NFS-Server dringend empfohlen, weil ein fsync auf dem Client den Serverdatenträger ohne diese Option nicht garantiert erreicht. Datenbanken setzen voraus, dass ein erfolgreiches fsync bedeutet, dass sich die Bytes auf einem stabilen Speichermedium befinden. Ist diese Annahme falsch, entsteht eine Beschädigung, die erst Wochen später sichtbar wird.

Legen Sie den Volume-Namen fest, bevor das Volume verschwindet

Compose benennt ein Volume als <project>_<volume>, und der Projektname entspricht standardmäßig dem Verzeichnisnamen. Die Identität des Volumes hängt damit von einem Verzeichnisnamen ab, den Benutzer ändern, ohne darüber nachzudenken.

Verschieben Sie /srv/app nach /srv/app-old oder benennen Sie den Schlüssel pgdata in der Compose-Datei um, erstellt der nächste docker compose up -d ein vollständig neues, leeres Volume. Postgres initialisiert darin einen neuen Cluster. Der Container ist fehlerfrei, die Anwendung startet, und alle Tabellen sind verschwunden. Das alte Volume liegt weiterhin unter seinem alten Namen auf der Festplatte. Das ist die gute Nachricht.

docker volume ls
docker volume inspect app_pgdata

Legen Sie die Namen fest, damit dies nicht passieren kann. Setzen Sie den Projektnamen und den Volume-Namen explizit:

name: myapp

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

volumes:
  pgdata:
    name: myapp_pgdata

Wenn ein Volume bereits Ihre Daten enthält, kopieren Sie die Daten bei gestoppter Datenbank:

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

Wenn Sie die Daten bei laufender Datenbank kopieren, erhalten Sie eine inkonsistente Kopie von Dateien, in die gerade geschrieben wurde. Stoppen Sie die Datenbank zuerst.

Wem gehört das Datenverzeichnis

Die offiziellen Postgres-, MySQL- und MongoDB-Images führen ihren Server als unprivilegierte numerische Benutzer-ID aus: 999 bei den Standard-Tags und 70 bei den Postgres--alpine-Tags. Wenn der Container als root startet, ändert der Entrypoint den Besitzer des Datenverzeichnisses auf diese Benutzer-ID und gibt anschließend seine Privilegien ab. Deshalb funktioniert ein leeres Bind-Mount normalerweise beim ersten Versuch.

Das funktioniert nicht mehr, sobald Sie user: in der Compose-Datei setzen. Dann hat der Entrypoint keine Privilegien mehr, um die Besitzrechte zu korrigieren. Postgres weist direkt darauf hin:

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

Ein Datenverzeichnis, das mit den falschen Berechtigungen vorhanden ist, führt zu einer anderen Meldung. Diese sollten Sie erkennen, weil die Korrektur chmod und nicht chown lautet:

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

Der MongoDB-Entrypoint korrigiert die Besitzrechte auf dieselbe Weise. Dieser Fehler mit der Lock-Datei bedeutet daher, dass dies nicht möglich war. Typischerweise ist user: gesetzt, oder das Mount lässt ein chown durch root nicht zu:

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.

Ändern Sie den Besitzer des Verzeichnisses auf dem Host auf die numerische ID, nicht auf einen Namen:

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

ls -ldn gibt Zahlen statt Namen aus und sollte 999 999 anzeigen. Verwenden Sie bei einem Postgres--alpine-Image stattdessen 70:70 und erwarten Sie 70 70. Das Konto namens postgres auf Ihrem Host und das Konto namens postgres im Image sind unabhängig voneinander: Der Kernel vergleicht die numerischen IDs, während die Namen auf jeder Seite separat aufgelöst werden. wie PUID und PGID Hostbenutzer in einen Container abbilden erläutert diese Zuordnung im Detail. Bei rootless Docker oder der User-Namespace-Zuordnung ändern sich die IDs erneut. Lesen Sie die IDs daher aus dem laufenden Container aus, statt 999 vorauszusetzen.

Bei Named Volumes entfällt dieser gesamte Abschnitt beim ersten Start, weil Docker ein leeres Verzeichnis erstellt und der Entrypoint dessen Besitz übernimmt.

Upgrades: Paket-Upgrade im Vergleich zur Änderung eines Image-Tags

Auf dem Host bringt apt upgrade Sie innerhalb einer Minor-Version weiter. Ihre Distribution führt kein Major-Upgrade einer Datenbank ungefragt durch. Wenn Sie den Versionssprung wählen, können beide Binärsätze gleichzeitig installiert werden. Genau das benötigt pg_upgrade.

In einem Container entspricht der Tag der Version. Ein Upgrade besteht daher aus der Änderung einer Zeile. Minor-Upgrades sind dadurch trivial, Major-Upgrades werden zu einem Verfahren.

Ändern Sie postgres:16 in postgres:17, führen Sie docker compose up -d aus, und der Container wird sofort beendet:

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.

Dabei wird nichts beschädigt. Die neuen Binärdateien können das alte Layout des Katalogs auf der Festplatte nicht lesen. Dieses Layout ändert sich zwischen Major-Versionen. Setzen Sie den Tag auf postgres:16 zurück, und der Container startet wieder. Dieses Rollback ist der einzige echte Upgrade-Vorteil von Containern.

Der unterstützte Weg ist Dump und Wiederherstellung. PostgreSQL erwartet vorzugsweise, dass der Dump mit dem neueren Client erstellt wird. Führen Sie ihn daher aus dem neuen Image gegen den weiterhin laufenden alten Server im Compose-Netzwerk aus:

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

Die Datei sollte mindestens einige Dutzend Kilobyte groß sein und mit einer Zeile enden, die PostgreSQL database cluster dump complete enthält. Eine Datei mit wenigen hundert Byte bedeutet, dass der Dump fehlgeschlagen ist und Sie gleich grundlos ein Volume löschen. Erst nach dieser Prüfung:

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

Planen Sie bei postgres:18 eine weitere Änderung ein. Ab 18 speichert das offizielle Image seine Daten in einem versionsspezifischen Verzeichnis unter /var/lib/postgresql (für 18: /var/lib/postgresql/18/docker) und deklariert sein Volume unter /var/lib/postgresql. Ein Volume, das weiterhin unter /var/lib/postgresql/data eingebunden ist, führt dazu, dass der Container mit einem Fehler beendet wird, der mit Error: in 18+, these Docker images are configured to store database data beginnt. Wenn Sie auf 18 oder höher wechseln, ändern Sie den Mount auf pgdata:/var/lib/postgresql. Die Pfade /var/lib/postgresql/data in diesem Beitrag gelten für 17 und früher.

Die anderen Datenbank-Engines unterscheiden sich:

  • MySQL 8 aktualisiert sein eigenes Datenverzeichnis beim Start. Eine Änderung des Minor-Tags erfordert daher normalerweise nur einen Neustart. Lesen Sie vor einem Wechsel zwischen Release-Serien die Release Notes und erstellen Sie unabhängig davon zuerst einen Dump.
  • Bei MariaDB muss mariadb-upgrade ausgeführt werden, nachdem der Server mit der neuen Version gestartet wurde.
  • MongoDB muss jeweils um genau eine Major-Version aktualisiert werden. Nach jedem Schritt setzen Sie die Feature Compatibility Version, bevor Sie fortfahren. Das Überspringen einer Version führt dazu, dass mongod den Start verweigert und eine UPGRADE PROBLEM-Zeile mit dem Namen featureCompatibilityVersion protokolliert. Ab MongoDB 7.0 benötigt der Befehl ein explizites Bestätigungs-Flag: db.adminCommand({ setFeatureCompatibilityVersion: "8.0", confirm: true }).
  • Redis lädt ältere Snapshot-Dateien problemlos, aber keine neueren. Ein Upgrade besteht daher aus einem Neustart. Ein Downgrade kann beim Laden der Daten fehlschlagen.

Die allgemeine Regel lautet: Ein Container macht ein Downgrade einfach, aber ein Upgrade nicht einfacher.

Warum beendet sich mein Datenbank-Container mit Exit-Code 137?

Der OOM-Killer des Kernels hat den Container beendet, weil nicht genügend Arbeitsspeicher verfügbar war. 137 entspricht 128 plus Signal 9.

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

docker compose ps --all zeigt Exited (137). Ohne --all listet Compose nur laufende Container auf. Die beendete Datenbank fehlt dann einfach in der Ausgabe. Die Inspect-Zeile lautet "OOMKilled": true. Das Kernel-Log enthält dazu einen passenden Eintrag:

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

OOMKilled sagt nur, dass ein OOM-Killer einen Prozess im Container beendet hat. Das Präfix Memory cgroup out of memory zeigt, dass das eigene Speicherlimit des Containers erreicht wurde. Bei einem Speichermangel auf dem gesamten Host wird stattdessen Out of memory: Killed process protokolliert. Die Ursache muss dann auf dem Host und nicht im Container behoben werden.

Der Mechanismus funktioniert folgendermaßen und führt häufig zu Fehlannahmen. Im Container melden free und /proc/meminfo weiterhin den gesamten Arbeitsspeicher des Hosts. Ein cgroup-Limit ändert diesen Wert nicht. PostgreSQL verwendet diesen Wert nicht zur Dimensionierung: shared_buffers hat standardmäßig den Wert 128MB. Jeder größere Wert wurde von Ihnen oder anhand einer Tuning-Anleitung festgelegt. Auch innodb_buffer_pool_size in MySQL hat standardmäßig den Wert 128M. Das Problem beginnt, wenn Einstellungen anhand des vom System gemeldeten Speichers dimensioniert werden. Die PostgreSQL-Dokumentation empfiehlt als Ausgangspunkt 25 % des Systemspeichers für shared_buffers. Auf einem Host mit 16 GB Arbeitsspeicher und einem Limit von 2 GB ergibt diese Regel 4 GB. Die cgroup beendet die Datenbank dann lange bevor der Host selbst unter Speicherdruck gerät. Einige Engines verwenden das Limit inzwischen für bestimmte Standardwerte. MySQL 9.3 und höher tut dies. MongoDB verwendet es für den WiredTiger-Cache, wenn das Limit erkannt werden kann. Keine dieser Datenbanken dimensioniert jedoch alle Einstellungen anhand dieses Werts. Die MongoDB-Dokumentation weist außerdem darauf hin, dass die Erkennung fehlschlagen kann. Ein Speicherlimit allein reicht daher nicht aus. Sie müssen der Datenbank zusätzlich mitteilen, wie viel Arbeitsspeicher sie verwenden darf:

  • PostgreSQL: Setzen Sie shared_buffers und achten Sie auf work_mem. work_mem gilt für jeden Sortier- oder Hash-Vorgang. Jede Verbindung kann mehrere solcher Vorgänge gleichzeitig ausführen. Ein großzügiger Wert multipliziert mit fünfzig Verbindungen ist daher die übliche Ursache für einen Container, der unter Last und nicht bereits beim Start beendet wird.
  • MySQL und MariaDB: Setzen Sie innodb_buffer_pool_size. Der Standardwert ist 128M. Deaktivieren Sie bei MySQL vor Version 9.3 innodb_dedicated_server in einem Container. Diese Einstellung dimensioniert den Buffer Pool anhand des Speichers der Maschine, also anhand des Host-Speichers. Ab Version 9.3 liest MySQL die Container-Limits. innodb_dedicated_server wird anhand dieser Limits dimensioniert. Eine explizite Größe für den Buffer Pool bleibt jedoch die besser vorhersehbare Wahl.
  • MongoDB: Setzen Sie die Größe des WiredTiger-Cache explizit. MongoDB verwendet das Container-Limit, wenn es dieses erkennen kann. hostInfo meldet es als memLimitMB. Die MongoDB-Dokumentation weist jedoch darauf hin, dass dies in einigen Fällen nicht funktioniert. Sie empfiehlt, --wiredTigerCacheSizeGB oder --wiredTigerCacheSizePct unterhalb des Speicherlimits des Containers festzulegen.
  • Redis: maxmemory ist standardmäßig unbegrenzt. Redis wächst daher, bis die cgroup den Prozess beendet. Setzen Sie maxmemory deutlich unterhalb des Container-Limits und wählen Sie einen maxmemory-policy.

PostgreSQL protokolliert das Ereignis auch aus eigener Sicht. Im Log finden Sie dann dieses Zeilenpaar:

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

Wenn ein Backend beendet wird, müssen alle anderen Backends neu gestartet werden, weil der Shared Memory inkonsistent sein kann. Für Ihre Anwendung bedeutet das einen Verbindungssturm und kein unauffälliges Ereignis. Speicherlimits in Docker Compose festlegen erläutert die Syntax sowie den Unterschied zwischen mem_limit und der Form deploy.resources.

Auf dem Host verschwindet das Problem nicht. Es verlagert sich nur. Ohne cgroup konkurriert die Datenbank mit allen anderen Prozessen auf dem Host. Der OOM-Killer des Hosts wählt anhand eines Scores ein Opfer aus. Das kann auch sshd sein. Ein Limit, das die Datenbank kontrolliert beendet, ist im Betrieb leichter zu handhaben als ein OOM-Ereignis auf dem Host, das Sie aussperrt.

Backups: Datenbank intern sichern, extern sichern

Sichern Sie eine laufende Datenbank nicht, indem Sie ihr Datenverzeichnis kopieren. Eine Kopie auf Dateiebene, die während Schreibvorgängen des Servers erstellt wird, ist inkonsistent. Das stellen Sie erst beim Wiederherstellen fest.

Es gibt zwei zuverlässige Methoden: Erstellen Sie mit dem eigenen Werkzeug der laufenden Datenbank einen Dump und sichern Sie diesen, oder stoppen Sie den Container und kopieren Sie das Volume im ausgeschalteten Zustand.

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

-T ist entscheidend. Ohne diese Option kann docker compose exec ein Terminal an den Befehl anhängen. Die Terminalschnittstelle fügt dem Ausgabestream dann Wagenrückläufe hinzu. Ein Textdump lässt sich anschließend nur mit ungewöhnlichen Fehlern wiederherstellen. Ein Binärdump ist schlicht beschädigt. Der Fehler bleibt beim Backup unbemerkt und tritt erst einen Monat später deutlich hervor.

--single-transaction erstellt für mysqldump einen konsistenten Snapshot der InnoDB-Tabellen, ohne den gesamten Server zu sperren.

Diese Befehle schreiben jeweils eine Datei. Sie sind kein Backup-System: Es gibt keine Aufbewahrungsregeln, keine Kopie außerhalb des Servers und keine Verifizierung. Übergeben Sie das Dump-Verzeichnis an ein Werkzeug, das alle drei Aufgaben übernimmt. Genau dafür sind restic-Backups von einem VPS gedacht. Sichern Sie /srv/backups, nicht /var/lib/docker/volumes.

Führen Sie anschließend die Wiederherstellung aus. Ein Backup, das Sie noch nie wiederhergestellt haben, ist kein Backup:

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'

\dt sollte die Tabellen Ihrer Anwendung auflisten. Ein leeres Ergebnis oder Did not find any relations. bedeutet, dass der Dump nicht dem erwarteten Inhalt entspricht. Entfernen Sie restore_test, wenn Sie fertig sind.

Der Befehl, der alles löscht

docker compose down -v.

down entfernt nur die Container und das Netzwerk. -v entfernt außerdem jedes benannte Volume, das in dieser Compose-Datei deklariert ist, sowie jedes an diese Container angehängte anonyme Volume. Es gibt keine Rückfrage und keine Möglichkeit zum Rückgängigmachen. Dies ist die häufigste Methode, mit der eine selbst gehostete Datenbank zerstört wird. Meist passiert das bei der Fehlersuche an einem anderen Problem, weil eine Antwort in einem Forum dazu aufgefordert hat.

Vier Maßnahmen begrenzen den Schadensumfang:

  • Deklarieren Sie das Datenbank-Volume mit external: true. Compose entfernt kein Volume, das es nicht selbst verwaltet. Daher kann -v dieses Volume nicht erreichen. Sie legen es einmalig mit docker volume create myapp_pgdata an.
  • Verwenden Sie docker compose stop und docker compose start für reguläre Neustarts. down im Vergleich zu stop in Compose erläutert, was die beiden Befehle jeweils entfernen.
  • Speichern Sie Dumps in einem Host-Pfad außerhalb aller Volumes, die Compose verwaltet.
  • Fügen Sie -v niemals aus einer Antwort zur Fehlersuche in einen Stack ein, der Daten enthält, die Sie benötigen.

Datenbank-Port nicht veröffentlichen

Diese Zeile stellt Ihre Datenbank im öffentlichen Internet bereit:

    ports:
      - "5432:5432"

Sie bindet den Port an alle Interfaces. Docker schreibt das Ziel des Pakets um, bevor die Input-Regeln Ihrer Firewall das Paket sehen. Die Regeln von ufw befinden sich in der Input-Kette. Deshalb bewirkt ufw deny 5432 überhaupt nichts. Warum veröffentlichte Docker-Ports ufw umgehen zeigt den Durchlauf durch die Ketten.

Eine Anwendung im selben Compose-Projekt erreicht die Datenbank über den Servicenamen im Compose-Netzwerk. Dafür ist kein veröffentlichter Port erforderlich. Löschen Sie den Block. Wenn Sie einen Client auf dem Host verwenden möchten, binden Sie den Port ausschließlich an das Loopback-Interface:

    ports:
      - "127.0.0.1:5432:5432"

Prüfen Sie, welcher Prozess tatsächlich lauscht:

sudo ss -ltnp | grep 5432

127.0.0.1:5432 ist der gewünschte Zustand. 0.0.0.0:5432 bedeutet, dass jeder Ihr Passwort ausprobieren kann.

Was wo ausgeführt wird

Eine Anwendung auf einem VPS. Verwenden Sie einen Container. Nutzen Sie ein benanntes Volume mit festgelegtem Namen, veröffentlichen Sie keinen Port, setzen Sie ein Speicherlimit mit passenden Datenbankeinstellungen und erstellen Sie jede Nacht einen Dump in einen Host-Pfad, den restic erfasst. Beginnen Sie mit einer sauberen Docker-Installation auf einem VPS und verwalten Sie den Stack in einer einzigen Compose-Datei, die Sie in das Repository einchecken. Der Vorteil ist konkret: Die Datenbankversion steht als prüfbare Zeile in git.

Ein Host mit mehreren Diensten. Verwenden Sie Container und eine Datenbank pro Anwendung, nicht einen gemeinsamen Server für alle Anwendungen. Ein gemeinsamer Server bindet jede Anwendung an denselben Upgrade-Zeitplan. Eine außer Kontrolle geratene Abfrage verursacht dann einen Ausfall für alle. Geben Sie jedem Container ein eigenes Speicherlimit, damit eine fehlerhafte Abfrage auf die Anwendung begrenzt bleibt, die sie ausgelöst hat. Mehrere kleine Postgres-Instanzen benötigen etwas mehr Speicherplatz und deutlich weniger Abstimmung.

Die Datenbank ist das Produkt. Betreiben Sie sie auf dem Host aus dem Paket-Repository des Herstellers oder verwenden Sie einen Managed Service. pg_upgrade benötigt beide Hauptversionen der Binärdateien gleichzeitig. Das ermöglichen Pakete, ein Image mit nur einer Version jedoch nicht. Replikation und Point-in-Time-Recovery mit WAL-(Write-Ahead-Log-)Archivierung sind einfacher, wenn die Datenbank den Rechner und seine Datenträger selbst verwaltet. Wählen Sie für das System, das Sie um 03:00 alarmiert, den unspektakulären Weg.

Die Anwendung ist klein. Erwägen Sie, vollständig auf eine Serverdatenbank zu verzichten. Eine Webanwendung mit einem einzigen Schreibprozess auf einem VPS ist mit SQLite in der Produktion auf einem VPS oft besser bedient. Das Backup besteht dann aus einer Datei und der Upgrade-Pfad aus einer Bibliotheksversion.

FAQ

Ist es sicher, eine Produktionsdatenbank in Docker zu betreiben?

Ja, für einen Anwendungs-Stack auf einem einzelnen Server. Ein Container ist ein Linux-Prozess mit Namespaces und cgroups. Mit einem eingebundenen Volume schreibt die Datenbank in dasselbe Host-Dateisystem wie bei einer Installation aus einem Paket. Die Risiken liegen im Betrieb, nicht bei der Geschwindigkeit: ein Volume ohne festgelegten Namen, ein Bind-Mount mit der falschen Benutzer-ID, eine nie getestete Wiederherstellung und docker compose down -v. Wenn Sie diese vier Punkte beheben, ist der Container geeignet. Installieren Sie die Datenbank direkt auf dem Host, wenn sie die Hauptarbeitslast bildet und Sie pg_upgrade, Replikation oder Point-in-Time-Recovery benötigen.

Sollte ich für Datenbankdaten einen Bind-Mount oder ein benanntes Volume verwenden?

Verwenden Sie ein benanntes Volume, sofern Sie keinen bestimmten Grund haben, den Host-Pfad zu kennen. Docker erstellt das Verzeichnis, und der Image-Entrypoint setzt beim ersten Start die Eigentümerrechte. Dadurch tritt das Berechtigungsproblem gar nicht erst auf. Legen Sie das Volume mit einem expliziten name: fest oder kennzeichnen Sie es als external: true. Andernfalls erzeugt das Umbenennen des Projektverzeichnisses stillschweigend ein neues leeres Volume und damit eine leere Datenbank. Ein Bind-Mount ist geeignet, wenn Sie das Host-Verzeichnis auf die numerische Benutzer-ID setzen, unter der das Image ausgeführt wird. Bei den Standard-Tags der offiziellen Postgres-, MySQL- und MongoDB-Images ist dies 999, bei den Postgres--alpine-Tags 70. Prüfen Sie dies mit ls -ldn, da ls -l den Namen Ihres Hosts für diese Nummer anzeigt. Dieser Name hat innerhalb des Containers keine Bedeutung.

Was löscht docker compose down -v?

Der Befehl entfernt die Container und das Netzwerk wie ein einfaches down. Zusätzlich entfernt -v jedes in dieser Compose-Datei deklarierte benannte Volume sowie jedes an diese Container angehängte anonyme Volume. Das schließt die Datenbank ein. Es gibt keine Bestätigungsabfrage und keine Wiederherstellungsmöglichkeit. Volumes mit der Kennzeichnung external: true werden nicht entfernt. Das ist der wichtigste Grund, ein Datenbank-Volume als extern zu kennzeichnen. Für einen regulären Neustart verwenden Sie stattdessen docker compose stop und docker compose start.

Wie aktualisiere ich PostgreSQL in Docker auf eine neue Hauptversion?

Erstellen Sie einen Dump und stellen Sie ihn wieder her. Wenn Sie postgres:16 in postgres:17 ändern und den Container neu starten, erhalten Sie FATAL: database files are incompatible with server mit einer DETAIL-Zeile, in der beide Versionen genannt werden. Die neuen Binärdateien können das alte Katalogformat nicht lesen. Es werden keine Daten beschädigt: Setzen Sie den alten Tag wieder ein, und der Container startet. Erstellen Sie mit dem Client der neuen Version einen pg_dumpall aus dem laufenden alten Container. Vergewissern Sie sich, dass die Datei mit PostgreSQL database cluster dump complete endet. Starten Sie anschließend den neuen Tag mit einem leeren Volume und laden Sie den Dump. Ab postgres:18 binden Sie dieses Volume unter /var/lib/postgresql statt unter /var/lib/postgresql/data ein. Für Minor-Upgrades innerhalb derselben Hauptversion genügen ein Pull und ein Neustart.

Warum beendet sich mein Datenbank-Container mit Exit-Code 137?

137 entspricht 128 plus Signal 9. Das bedeutet, dass ein Prozess sofort beendet wurde. Führen Sie docker inspect <container> | grep -i oomkilled aus. Ein Wert von true bedeutet, dass ein OOM-Killer einen Prozess im Container beendet hat. Ursache ist meist, dass der Container sein eigenes cgroup-Speicherlimit erreicht hat. Die üblichen Speicherparameter sind für den Host statt für den Container dimensioniert: Tools im Container melden weiterhin den gesamten Speicher des Hosts. Ein für 16 GB dimensionierter Puffer belegt dann Speicher innerhalb eines Limits von 2 GB. Setzen Sie shared_buffers und work_mem oder innodb_buffer_pool_size so, dass sie zum Speicherlimit des Containers passen. Prüfen Sie journalctl -k auf die passende Memory cgroup out of memory-Zeile. Damit bestätigen Sie, welchen Prozess der Kernel ausgewählt hat und dass das Limit des Containers statt eines hostweiten Out of memory-Kills erreicht wurde.

War dieser Artikel hilfreich?