Lorixen.
DE

Docker-Container nach dem Server-Neustart wieder starten

Kurz gesagt: Wenn Ihre Web-App, Ihr Buchungssystem oder Ihre Automatisierung in Docker läuft und nach einem nächtlichen Server-Neustart einfach nicht mehr erreichbar ist, fehlt meist eine Restart Policy. Laut Docker-Dokumentation startet ein Container ohne Angabe nicht automatisch neu, der Standard heißt no. Mit unless-stopped oder always kommt er nach einem Absturz und nach einem Neustart des Docker-Dienstes von selbst zurück. Zusätzlich muss der Docker-Dienst beim Hochfahren des Servers starten. Beides zusammen dauert wenige Minuten und erspart Ihnen den Anruf am Montagmorgen, dass „die Seite nicht geht“.

Woran Sie das Problem erkennen

Typisch ist ein Muster, das nur gelegentlich auftritt:

  • Nach Sicherheitsupdates oder Wartungsarbeiten des Hosters ist die Anwendung offline, obwohl der Server läuft.
  • Ein Teil funktioniert, ein anderer nicht, etwa die Website ohne Datenbank oder das Formular ohne Mailversand.
  • Ein Container stürzt wegen eines Fehlers ab und bleibt aus, bis jemand ihn händisch startet.
  • Der Befehl zum Anzeigen der laufenden Container zeigt weniger Einträge als erwartet.

Gerade bei kleinen Installationen, die eine Agentur einmal eingerichtet hat, fällt das erst auf, wenn der Server zum ersten Mal neu startet. Bis dahin lief alles, weil niemand den Fall ausprobiert hat.

Die vier Restart Policies

Die Docker-Dokumentation nennt vier Werte für die Option restart:

  • no: Der Container startet nicht automatisch neu. Das ist der Standard.
  • on-failure: Neustart nur, wenn der Container mit einem Fehler endet, also mit einem Exit-Code ungleich null. Optional lässt sich die Zahl der Versuche begrenzen. Laut Dokumentation startet diese Policy den Container nicht, wenn der Docker-Dienst neu startet.
  • always: Der Container wird immer neu gestartet, wenn er stoppt. Haben Sie ihn händisch gestoppt, startet er erst wieder, wenn der Docker-Dienst neu startet oder Sie ihn selbst starten.
  • unless-stopped: Wie always, mit einem Unterschied: Ein gestoppter Container bleibt gestoppt, auch nach einem Neustart des Docker-Dienstes.

Für die meisten Geschäftsanwendungen ist unless-stopped die passende Wahl. Die Anwendung kommt nach Abstürzen und Neustarts zurück, und wenn Sie einen Container bewusst stoppen, etwa für Wartung, bleibt er aus.

Eine wichtige Einschränkung

Die Dokumentation beschreibt eine Bedingung, die oft übersehen wird: Eine Restart Policy wirkt erst, nachdem ein Container erfolgreich gestartet ist. Erfolgreich heißt hier, dass er mindestens zehn Sekunden lief und Docker begonnen hat, ihn zu überwachen. Das soll verhindern, dass ein Container, der gar nicht hochkommt, in einer Endlosschleife neu startet.

Bricht Ihre Anwendung also sofort nach dem Start ab, etwa weil eine Konfigurationsdatei fehlt, hilft die Policy nicht. Dann müssen Sie den eigentlichen Fehler im Protokoll des Containers suchen.

Die Policy setzen

Beim Starten eines neuen Containers geben Sie die Policy direkt mit, zum Beispiel:

docker run -d --restart unless-stopped --name buchung mein-image

Für Container, die bereits laufen, lässt sich die Policy laut Dokumentation mit docker update nachträglich ändern:

docker update --restart unless-stopped buchung

Wenn Ihre Anwendung mit Docker Compose beschrieben ist, setzen Sie in der Datei bei jedem Dienst den Eintrag restart mit dem gewünschten Wert. So geht die Einstellung bei einer Neuinstallation nicht verloren. Prüfen Sie dabei alle Dienste, nicht nur den Webserver: Datenbank, Cache, Mail-Weiterleitung und Hintergrundprozesse brauchen die Policy genauso.

Der Docker-Dienst muss mitstarten

Eine Restart Policy setzt voraus, dass der Docker-Dienst selbst läuft. Auf den meisten Linux-Servern wird er über das Init-System gestartet. Ob er beim Hochfahren automatisch startet, lässt sich dort prüfen und bei Bedarf aktivieren. Bei vielen Installationen ist das schon der Fall, bei manchen nicht, etwa wenn Docker händisch nachinstalliert wurde.

Ein schneller Test: Starten Sie den Server in einem ruhigen Moment bewusst neu und prüfen Sie danach, ob alle Container laufen und die Anwendung erreichbar ist. Das ist der einzige Test, der wirklich zeigt, ob alles zusammenspielt.

Reihenfolge beim Start beachten

Starten nach einem Neustart alle Container gleichzeitig, kann die Anwendung schneller hochkommen als die Datenbank. Sie bricht dann mit einem Verbindungsfehler ab. Zwei Maßnahmen helfen:

  • Die Anwendung versucht die Verbindung zur Datenbank mehrmals mit kurzer Pause, statt beim ersten Fehler aufzugeben.
  • In Docker Compose beschreiben Sie Abhängigkeiten und, wo möglich, eine Gesundheitsprüfung der Datenbank, auf die der Anwendungscontainer wartet.

Kombiniert mit der Restart Policy kommt die Anwendung dann auch zuverlässig zurück, wenn sie im ersten Anlauf zu früh dran war.

Überwachung nicht vergessen

Eine Restart Policy hält die Anwendung am Laufen, verdeckt aber auch Probleme. Startet ein Container jede Stunde neu, merkt das niemand, solange die Seite kurz danach wieder geht. Prüfen Sie daher regelmäßig die Zahl der Neustarts, die Docker pro Container anzeigt, und richten Sie einen einfachen externen Check ein, der Ihre Startseite oder einen Statusendpunkt abruft und Sie bei Ausfällen per E-Mail informiert.

Eine kurze Checkliste für Ihre Installation

Gehen Sie nach dem Einrichten diese Punkte durch und notieren Sie das Ergebnis in Ihrer Betriebsdokumentation:

  1. Jeder dauerhaft laufende Dienst hat eine Restart Policy, idealerweise unless-stopped.
  2. Die Policy steht auch in der Compose-Datei oder im Installationsskript, nicht nur im laufenden System.
  3. Der Docker-Dienst startet beim Hochfahren des Servers automatisch.
  4. Die Anwendung wartet auf ihre Datenbank oder versucht die Verbindung mehrmals.
  5. Ein Testneustart des ganzen Servers wurde durchgeführt und die Anwendung war danach ohne Eingriff erreichbar.
  6. Ein externer Check meldet Ausfälle, und jemand im Betrieb weiß, wer dann zuständig ist.

So kann auch eine Vertretung im Urlaub nachvollziehen, was eingerichtet ist und was im Ernstfall zu tun ist.

Beispiel aus der Praxis

Eine Tischlerei in Innsbruck betreibt ein kleines Portal, über das Kunden Angebote ansehen und freigeben. Das Portal lief in drei Containern. Nach einem Wartungsfenster des Hosters war es einen ganzen Vormittag offline, weil keiner der Container eine Restart Policy hatte. Nach dem Setzen von unless-stopped für alle drei Dienste, einer Wiederholungslogik für die Datenbankverbindung und einem Testneustart kommt das Portal seither von selbst zurück. Das Beispiel ist illustrativ.

Häufige Fragen

Welche Policy soll ich nehmen?

Für dauerhaft laufende Anwendungen meist unless-stopped. Für einmalige Aufgaben, die nach getaner Arbeit enden sollen, ist no oder on-failure passender.

Warum startet mein Container trotz Policy nicht?

Entweder läuft der Docker-Dienst nicht, oder der Container ist nie erfolgreich gestartet. Laut Dokumentation greift die Policy erst nach mindestens zehn Sekunden Laufzeit.

Kann ich die Policy ändern, ohne den Container neu anzulegen?

Ja, mit docker update und der Option restart. In einer Compose-Datei sollten Sie die Änderung zusätzlich eintragen.

Brauche ich zusätzlich einen Prozessmanager?

Die Docker-Dokumentation empfiehlt Restart Policies und rät davon ab, Container über Prozessmanager zu starten.

Wenn Ihre Docker-Anwendung nach einem Neustart nicht zuverlässig zurückkommt, prüfen wir die Einrichtung gerne mit Ihnen: Docker-Setup prüfen lassen.

Quellen

WhatsAppTermin buchen