88. pepsi-failure-bouncer¶
Leitet fehlgeschlagene/Timeout-Nachrichten an die Bounce-Stage.
88.1. Rolle¶
Wenn ihre Stage aufgibt, endet eine Nachricht in der Pipeline nach dem Ingress als failed oder timeout. failed ist sie, wenn eine Stage einen dauerhaften Fehler meldete, ein Fehler MAX_LIFETIME an einer Stage ohne BOUNCE_STAGE überdauerte, die Nachricht ihren Worker dreimal zum Absturz brachte oder sie an einer Stage wartete, die die Konfiguration nicht mehr nennt. timeout ist sie, wenn sie ihren Worker dreimal über MAX_RUNTIME hinaus festhielt oder in einer pepsi-stage-relay-to-*-Stage bei MAX_LIFETIME noch immer beendet wurde. Der Dispatcher reiht einen solchen Datensatz nie erneut ein, sodass die Nachricht ohne Eingriff des Betreibers in pepsi.workqueue steckenbleibt und der Absender nie benachrichtigt wird.
pepsi-failure-bouncer verschiebt jede steckengebliebene Nachricht zum konfigurierten [pepsi-failure-bouncer] BOUNCE_STAGE und setzt sie auf pending zurück. Der Dispatcher führt dann die Bounce-Stage (pepsi-stage-bounce) aus, die eine Zustellungsstatusbenachrichtigung ausgibt, wie es das RFC-3461-NOTIFY des Absenders verlangt. Eine Nachricht, die bereits an der Bounce-Stage steht, bleibt unberührt, sodass ein Bounce, der an dieser Stage fehlschlägt, nicht in eine Schleife gerät; einer, der nach ihr fehlschlägt (eine nicht weiterleitbare Null-Absender-DSN), wird zurückverschoben und einfach verworfen (ein Bounce wird nie erneut gebounct). BOUNCE_STAGE muss daher zu einer echten Bounce-Stage führen: pepsi-setup lehnt einen Wert ab, der keine Stage benennt, und warnt vor einem, der nicht direkt pepsi-stage-bounce ausführt.
Es wartet zuerst: Eine Nachricht wird erst verschoben, wenn sie seit MIN_AGE fehlgeschlagen ist (Standardwert eine Stunde, gezählt ab state.failed_at, das die Datenbank stempelt). So bleibt dem Betreiber Zeit, sie mit pepsi-queue zurückzusetzen. Jede verschobene Nachricht wird als Warnung protokolliert, mit ihrem Absender, der Stage, an der sie fehlschlug, und dem festgehaltenen Fehler, den die Bounce-Stage nicht in die DSN übernimmt; die Stage wird als state.failed_stage behalten. Die Kopie eines Listenbeitrags für ein Mitglied (ein Datensatz mit state.list.member) wird stattdessen gelöscht: Ihr Umschlagabsender ist die eigene Bounce-Adresse der Liste, sodass eine DSN den Fehler dieses Hosts dem Mitglied anrechnen würde. Ein Beitrag auf dem Weg zu einer Liste hat seinen Verfasser als Umschlagabsender und wird wie jede andere Nachricht gebounct. Auch eine Nachricht, deren Inhalt aus einem S/MIME-EnvelopedData stammt oder sich daraus nicht öffnen ließ, wird gelöscht (Telemetrie decrypt-dropped): Eine DSN würde einem Absender, der das CBC-Chiffrat verändert hat, verraten, ob dessen Padding gültig war (CBC-Padding- und Format-Orakel gegen nicht authentifiziertes S/MIME). Nachdem es Datensätze verschoben hat, weckt es den Dispatcher selbst.
Es verbindet sich über [pepsi-postgres] und wird durch [pepsi-failure-bouncer] konfiguriert: BOUNCE_STAGE (erforderlich, die Stage, zu der steckengebliebene Nachrichten verschoben werden) und MIN_AGE. Es ist keine Stage. Als root gestartet, wechselt es vor dem Verbinden zum Dienstkonto pepsi, der Rolle, der die Warteschlange gehört. Referenz: pepsi-failure-bouncer(1).
88.2. Modi¶
service (der Standardwert, kein
--once) — ein langlebiger Prozess, der den Kanalworkqueue_failedmitLISTENabhört (ausgelöst vom Triggerworkqueue_failed_notify, wann immer ein Datensatz failed/timeout wird) und jede Nachricht bouncet, sobald sieMIN_AGEalt ist, wobei er für den ältesten wartenden Fehlschlag aufwacht, wenn vorher keine Benachrichtigung kommt. Er fegt alle bereits steckengebliebenen Nachrichten beim Start und bei jeder Wiederverbindung durch, sodass nichts übersehen wird, und läuft bisSIGINT/SIGTERM. Keine mitgelieferte Unit führt diesen Modus aus.–once — die derzeit steckengebliebenen Nachrichten ein einziges Mal durchfegen und beenden. Das führt
pepsi-failure-bouncer.timerals Kontopepsialle zehn Minuten aus;pepsi.targetwill den Timer. Ein Testhost, der fehlgeschlagene Nachrichten zur Diagnose behalten will, maskiert ihn (systemctl mask --now pepsi-failure-bouncer.timer), da das Target einen bloß deaktivierten Timer wieder starten würde.
--failed-only / --timeout-only beschränken einen der beiden Modi auf einen der beiden terminalen Zustände.
Warum ein Fehlschlag nicht in einer Schleife durch die Bounce-Stage laufen kann, ist Teil der Verfügbarkeitsanalyse (Verfügbarkeit); welche DSNs die Bounce-Stage dann zurückhält, wird unter pepsi-stage-bounce beschrieben.
88.3. Siehe auch¶
pepsi-dispatch, pepsi-stage-bounce, pepsi-queue, pepsi-status, pepsi-failure-bouncer(1), pepsi.conf(5).