Healthcheck-Pfad

Ein Healthcheck-Pfad ermöglicht es der Plattform, regelmäßig zu überprüfen, ob Ihre Anwendung ausgeführt wird und korrekt funktioniert.

Standardmäßig führt die Plattform, wenn kein Healthcheck aktiviert ist, nach dem Deployment nur eine grundlegende Prüfung durch: Sie stellt sicher, dass der Container der Anwendung erfolgreich gestartet wurde. In diesem Fall wird der tatsächliche Zustand der Anwendung nicht bewertet – die App kann falsch reagieren oder überhaupt nicht reagieren, dennoch wird das Deployment als erfolgreich markiert.

Um dies zu verhindern, können Sie einen Healthcheck-Pfad konfigurieren. Ihre Anwendung muss einen Endpunkt bereitstellen, der nicht von externen Systemen (wie einer Datenbank oder Drittanbieter-Services) abhängt und den internen Zustand der Anwendung korrekt widerspiegelt.

Sie können diesen Endpunkt während der Konfiguration angeben: zum Beispiel /health, /status oder /ping.

Standardmäßig prüft das System während des Deployments nur die Root-URL (/). Es sendet eine Anfrage an die Hauptseite, und wenn der Antwortstatus nicht im Bereich 2xx liegt, wird das Deployment als fehlgeschlagen betrachtet.

Wie Healthchecks funktionieren

Healthcheck-Anfragen werden immer von localhost aus gesendet.

Die einzige Anforderung ist, dass der Endpunkt einen 2xx-Statuscode zurückgibt. Der Antwortinhalt spielt keine Rolle; nur der Statuscode ist entscheidend.

Während eines Redeployments

Wenn ein Healthcheck-Pfad konfiguriert ist, sendet das System bis zu drei aufeinanderfolgende GET-Anfragen an die neue Anwendungsinstanz.

• Wenn mindestens eine Anfrage einen 2xx-Statuscode zurückgibt, gilt das Deployment als erfolgreich, und die neue Version wird aktiv.

• Wenn alle drei Versuche fehlschlagen (jeder Statuscode außer 2xx), wird das Deployment als fehlgeschlagen markiert, und die vorherige Version bleibt aktiv.

Healthchecks werden fortgesetzt, bis eine der folgenden Bedingungen erfüllt ist:

• eine einzelne erfolgreiche Antwort,

• drei aufeinanderfolgende fehlgeschlagene Antworten, wobei die letzte 40 Sekunden nach dem Start erfolgt,

• oder 180 Sekunden vergehen; tritt innerhalb dieser Zeit keiner der oben genannten Fälle ein, wird das Deployment als fehlgeschlagen betrachtet.

Wenn die Prüfung fehlschlägt, erscheint eine Healthcheck-Fehlermeldung in den Deployment-Logs.

Nach dem Start

Sobald ein Deployment erfolgreich ist, überprüft das System weiterhin den Zustand der Anwendung mit einer Anfrage alle 30 Sekunden.

Wenn drei aufeinanderfolgende Prüfungen fehlschlagen, wird die Anwendung automatisch neu gestartet. Dieses Ereignis erscheint in den Anwendungs-Logs.

Konfigurieren eines Healthcheck-Pfads

Sie können einen Healthcheck-Pfad beim Erstellen einer neuen Anwendung oder später für eine bestehende Anwendung konfigurieren.

Beim Erstellen einer Anwendung

Geben Sie im Abschnitt App-Einstellungen den gewünschten Pfad im Feld Health Check path ein.

Wenn Ihre Anwendung beispielsweise einen /health-Endpunkt unter https://domain/health bereitstellt, setzen Sie:

/health

Für eine bestehende Anwendung

1. Öffnen Sie die Anwendung im Control Panel.

2. Gehen Sie zur Registerkarte Einstellungen.

3. Klicken Sie im Abschnitt Deploy-Einstellungen auf Bearbeiten.

4. Geben Sie den Healthcheck-Pfad ein.

5. Klicken Sie auf Daten speichern.

Ein neues Deployment wird automatisch mit der aktualisierten Einstellung ausgelöst.

Docker und Docker Compose

Dockerfile-Deployments

Wenn Ihre Anwendung über ein Dockerfile bereitgestellt wird, können Sie den Healthcheck-Pfad weiterhin im Control Panel konfigurieren.

Enthält das Dockerfile jedoch eine HEALTHCHECK-Anweisung, hat diese Vorrang, und die Einstellung im Control Panel wird ignoriert.

Beispiel:

HEALTHCHECK --interval=30s --timeout=10s --retries=3 \
  CMD curl -f http://localhost/health || exit 1

Weitere Details finden Sie in der offiziellen Docker-Dokumentation.

Docker Compose-Deployments

Für Docker-Compose-Deployments wird die Konfiguration des Healthcheck-Pfads im Control Panel nicht unterstützt.

Wenn Ihre Services ein Dockerfile verwenden, können Sie HEALTHCHECK direkt darin konfigurieren – es verhält sich wie oben beschrieben.