BrillianzeHomelab
Vergleich
BsN-Ochsenkopf in Schwarz-Rot-Gold mit goldenem C

Docker-Healthcheck und Restart-Policy: zwei Aufgaben

Ein Container ist gestartet, aber die Weboberfläche reagiert nicht. Oder ein Dienst beendet sich und bleibt nach einem Hostneustart aus. Beide Probleme sehen von außen ähnlich aus, erfordern aber verschiedene Mittel. Healthchecks beschreiben den beobachteten Zustand einer laufenden Anwendung; Restart-Policies regeln, ob Docker einen beendeten Container erneut startet. Wer beides verwechselt, baut eine Automatik, die den eigentlichen Fehler nicht behebt.

Was ein Healthcheck tatsächlich meldet

Ein Healthcheck führt eine im Image oder Compose-Service definierte Prüfung in Intervallen aus. Die Compose-Referenz dokumentiert dafür Test, Intervall, Timeout, Wiederholungen und Startfrist.[3] Die Prüfung muss zur Anwendung passen: Bei einer Datenbank ist eine echte Bereitschaftsanfrage aussagekräftiger als die bloße Existenz eines Prozesses. Ein Check kann aber auch falsch-negativ werden, wenn sein Prüfwerkzeug im Container fehlt oder die Anwendung beim Start länger benötigt. Notiere daher, was als gesund gilt und ab welchem Zeitpunkt die Prüfung belastbar ist.

Die Statusanzeige „unhealthy“ ist zunächst ein Diagnosehinweis, keine Reparatur. Plane eine Beobachtung, die diesen Status meldet, und suche im Ereignisfall in Dienstprotokollen und Abhängigkeiten nach der Ursache. Ein Check gegen den eigenen Port beweist außerdem nicht automatisch, dass ein externer Nutzer den Dienst über Proxy, DNS und Netzwerk erreicht.

Wofür die Restart-Policy zuständig ist

Docker beschreibt „no“, „on-failure“, „always“ und „unless-stopped“ mit unterschiedlichen Regeln für beendete Container und Daemon-Neustarts.[1] „on-failure“ reagiert auf einen fehlerhaften Exit-Code; „unless-stopped“ merkt sich einen bewussten Stopp auch über einen Daemon-Neustart hinweg. Wähle die Regel nach dem Betrieb: ein dauerhaft benötigter Dienst kann von einem automatischen Neustart profitieren, ein einmaliger Importprozess soll vielleicht gerade nicht dauerhaft wiederkehren.

Eine Restart-Policy startet nicht allein deshalb neu, weil ein weiterhin laufender Container als „unhealthy“ gilt. Wer das erwartet, braucht eine gesondert geplante Reaktion und muss Endlosschleifen vermeiden. Auch wiederholte Abstürze sind kein Zeichen, dass „mehr Neustarts“ die richtige Lösung wären. Sichere vor Änderungen die relevanten Logs und prüfe den Exit-Grund.

Bereitschaft und Abhängigkeiten in Compose

Compose startet Dienste in Abhängigkeitsreihenfolge, wartet standardmäßig aber nur auf den laufenden Container, nicht auf eine betriebsbereite Anwendung.[2] Für einen abhängigen Dienst kann „service_healthy“ an einen passenden Healthcheck des vorgelagerten Dienstes gekoppelt werden. Die Docker-Anleitung zeigt dieses Muster für eine Datenbank und eine Webanwendung.[2] Es löst den Startzeitpunkt, nicht automatisch jede spätere Störung im laufenden Betrieb.

Prüfe vor dem Einsatz, ob deine Anwendung einen Verlust der Datenbankverbindung selbst übersteht und später neu verbindet. Sonst kann selbst eine korrekte Startreihenfolge einen Ausfall nach Stunden nicht auffangen. Die Option „restart“ innerhalb einer Compose-Abhängigkeit hat eine andere Bedeutung als die Restart-Policy des Service; lies die jeweilige Stelle in der offiziellen Anleitung, bevor du sie gleichsetzt.[2]

Kleiner Funktionstest

Teste drei Fälle getrennt: einen gesunden Start, einen absichtlich fehlschlagenden Healthcheck bei weiter laufendem Prozess und ein reguläres Beenden des Testcontainers. Beobachte jeweils Status, Logs und Neustartverhalten; wiederhole den Test nach einem kontrollierten Daemon-Neustart. Verwende dafür einen unwichtigen Testdienst statt einer Produktivdatenbank. Die Entscheidung ist gelungen, wenn ein Defekt sichtbar wird, ein beendeter Dienst gemäß der gewählten Regel reagiert und kein blindes Neustartkarussell entsteht.

Offizielle Quellen

  1. Docker: Container automatisch starten
  2. Docker: Startreihenfolge in Compose
  3. Docker: Compose-Service-Referenz