Ein Hilfsprogramm, das einen Webserver benötigt, kann seine erste Anfrage zu früh senden, obwohl beide in der richtigen Reihenfolge gestartet wurden. Ein Healthcheck ist ein kleiner Test, den Docker ausführt. Er zeigt zum Beispiel, ob ein Dienst eine HTTP-Anfrage beantworten kann.
Docker Compose · Lektion 6
Dienstabhängigkeiten
Lerne, warum die richtige Startreihenfolge allein noch nicht zeigt, ob ein Dienst Anfragen beantworten kann.
Die Betriebsbereitschaft prüfen
In diesem separaten Beispiel läuft die Prüfung im Webcontainer. Sie ruft dort die lokale Webseite ab. Eine erfolgreiche Anfrage zeigt Docker, dass der Server von dieser Stelle aus erreichbar ist und antwortet.
services:
web:
image: nginx:alpine
healthcheck:
test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1/"]
interval: 3s
timeout: 2s
retries: 5
toolbox:
image: busybox:1.36
command: ["sleep", "3600"]
depends_on:
web:
condition: service_healthy
Speichere das Beispiel als compose.health.yaml im selben Übungsordner. Die Prüfung läuft in regelmäßigen Abständen und hat für jeden Versuch ein Zeitlimit. Sie prüft die Antwort innerhalb des Webcontainers.
Wo läuft wget für diesen Healthcheck?
Auf einen einsatzbereiten Dienst warten
Mit der Bedingung service_healthy wartet Compose auf einen erfolgreichen Healthcheck, bevor es den abhängigen Werkzeugcontainer startet. Eine reine Startreihenfolge lässt den Werkzeugcontainer anlaufen, sobald der Webdienst läuft. Das kann schon vor der ersten erfolgreichen Anfrage geschehen.
$ docker compose -p journey-health -f compose.health.yaml up -d
$ docker compose -p journey-health -f compose.health.yaml ps
Prüfe, ob in der Zeile von web ein gesunder Zustand angezeigt wird und der Werkzeugcontainer läuft.
Der Webprozess läuft, aber die lokale Anfrage schlägt noch fehl. Welche Einstellung soll den Start des Werkzeugcontainers verzögern?

Auf einen späteren Ausfall reagieren
Eine Startbedingung in Compose bestimmt, wann abhängige Dienste anlaufen. Ein zuvor gesunder Dienst kann nach dem Start trotzdem ausfallen. Ein Client sollte mit fehlgeschlagenen Anfragen umgehen und die Verbindung neu aufbauen, sobald der benötigte Dienst wieder erreichbar ist. Prüfe den aktuellen Zustand des Dienstes und sende eine direkte Anfrage.
Eine Anfrage schlägt eine Stunde nach dem Start beider Dienste fehl. Was hilft dir jetzt weiter?
Aus zwei Blickwinkeln prüfen
Ein erfolgreicher lokaler Healthcheck zeigt, was aus dem Webcontainer selbst erreichbar ist. Der Werkzeugcontainer benötigt weiterhin das Projektnetzwerk und eine nutzbare Dienstadresse. Prüfe das Ergebnis des Healthchecks und die Anfrage aus dem Werkzeugcontainer getrennt.
Der Healthcheck ist grün, aber die Anfrage aus dem Werkzeugcontainer schlägt fehl. Welcher Vergleich hilft bei der Fehlersuche?
Lektion abgeschlossen
Sie haben Dienstabhängigkeiten abgeschlossen
Du kannst jetzt anhand eines Healthchecks beurteilen, ob eine Abhängigkeit einsatzbereit ist.
Ermittle, was der Healthcheck tatsächlich prüft.
Verwende eine Bedingung für die Betriebsbereitschaft, wenn die Startreihenfolge allein nicht ausreicht.
Prüfe den aktuellen Zustand, wenn ein Dienst später ausfällt.
Lernfortschritt speichern
Erstellen Sie ein kostenloses Konto, um diese Lektion zu speichern und auf jedem Gerät weiterzulernen.
Kostenloses Konto erstellen