69. pepsi-queue

Inspiziert und repariert die Nachrichten-Warteschlange.

69.1. Rolle

pepsi-queue ist das Diagnose- und Reparaturwerkzeug des Betreibers für die pepsi.workqueue-Tabelle. Es verbindet sich über den gemeinsamen [pepsi-postgres]-Abschnitt; seine einzige eigene Option ist [pepsi-queue] QUARANTINE_MAX_AGE_DAYS (gelesen von gc). Als root gestartet, läuft es vor dem Verbinden als Dienstkonto pepsi weiter, sodass kein sudo -u pepsi nötig ist. Referenz: pepsi-queue(1).

69.2. Funktionen

  • list — listet die eingereihten Nachrichten nach workqueue_id geordnet auf, wahlweise als --json (workqueue_id, stage, status, mail_from, subject, received_at, state), mit --limit (standardmäßig 100), den Filtern --stage und --status, einem optionalen positionalen WORKQUEUE_ID, das die Ausgabe auf eine Nachricht beschränkt, und --state-only, um statt der Datensatzzusammenfassung den vollständigen, ungekürzten JSON-state jeder passenden Nachricht auszugeben. --headers/--body schreiben den gespeicherten Header-Block und/oder Rumpf einer Nachricht Byte für Byte. list ist die Standardaktion, sein positionales Argument und seine Optionen werden daher auch ohne Unterbefehl angenommen (pepsi-queue 5, pepsi-queue --state-only 5), aber nicht vor einem anderen Unterbefehl. Dort sähen sie aus wie ein Filter, den dieser Unterbefehl nicht anwendet.

  • delete WORKQUEUE_ID — entfernt eine Nachricht dauerhaft.

  • set-stage WORKQUEUE_ID STAGE — weist eine Nachricht einer gegebenen Stage neu zu und setzt ihren status auf pending zurück (ihr state bleibt unverändert), damit die neue Stage sie aufnimmt.

  • clear-all — massenhaftes „Losmachen“: setzt jede running/paused-Nachricht zurück auf pending (failed/timeout bleiben unberührt, ebenso Mail, die in einer pepsi-stage-quarantine-Stage zurückgehalten wird) — die Wiederherstellung nach einem Absturz oder einer ins Stocken geratenen Stage.

  • quarantine list|show|release|delete — die Nachrichten, die eine pepsi-stage-quarantine-Stage zurückhält, nach Token: list (--json, --limit) zeigt, wann jede eintraf und seit wann sie zurückgehalten wird, ihren Umschlag und wer sie in die Quarantäne geschickt hat und warum (state.quarantine.by und reason); show zeigt eine; release gibt sie an ihre Stage zurück, die sie an ihre RELEASE_STAGE weiterschickt; delete entfernt sie nach einer Bestätigung (--yes in einem Skript) und hält das im optionalen Maillog fest.

  • gc — räumt abgelaufene Daten auf. Es löscht die Nonces des Herkunftsnachweises (pepsi.origin_nonce), deren Ablaufzeit vorüber ist, und die Datensätze des MX-Adress-Caches (pepsi.dns_address), deren DNS-TTL abgelaufen ist. Im Cache der MTA-STS-Richtlinien (pepsi.mta_sts_policy) frischt es jede fällige Richtlinie unabhängig vom Mailfluss auf (RFC 8461 Abschnitt 10.2) und löscht die Richtlinien, deren max_age ohne erfolgreiche Auffrischung abgelaufen ist. Außerdem löscht es die festgehaltenen Bestätigungsanfragen von Mailinglisten (pepsi.list_confirmation) nach Ablauf ihres Fensters, die gelernten list-id-Whitelist-Datensätze, die länger als ihr max_idle ungenutzt sind, die zweiten Faktoren, die per E-Mail eingerichtet und nicht rechtzeitig bestätigt wurden (pepsi.otp_pending), und die DMARC-Sammelberichte (pepsi.dmarc_report), die älter als [pepsi-dmarc-reports] RETAIN_DAYS sind. Derselbe Lauf prüft jedes Login im Login-Zuordnungsverzeichnis nach RFC 7293 erneut gegen passwd, sodass ein Login, das den Inhaber gewechselt hat, den Zustand seines vorherigen Inhabers verliert (Ein Login, das den Eigentümer wechselt). Schließlich beendet er das Zurückhalten in einer Quarantäne-Stage nach [pepsi-queue] QUARANTINE_MAX_AGE_DAYS (Standardwert 14), und zwar in jeder Stage, die ein QUARANTINE_STAGE nennt, und in jeder pepsi-stage-quarantine-Stage ohne eigenes MAX_HOLD. Eine abgelaufene Nachricht wird ohne ihren Inhalt gebounct, mit zwei Ausnahmen, die stattdessen verworfen werden: die Kopie eines Listenbeitrags für ein Mitglied und eine Nachricht, deren Inhalt aus einem S/MIME-EnvelopedData-Chiffrat (AES-CBC) stammt oder sich daraus nicht öffnen ließ. Ein Bounce für Letztere würde ihrem Absender verraten, ob das Padding eines veränderten Chiffrats gültig war (Bounces und Antworten auf verschlüsselte Mail). Der Befehl ist für einen Timer gedacht; das Debian-Paket bindet einen stündlichen ein (pepsi-origin-gc.timer).

delete, set-stage, clear-all und quarantine release/delete werden im Audit-Log festgehalten, so wie dieselben über die administrative API ausgeführten Aktionen.

Die verändernden Unterbefehle wirken sofort und sind nicht umkehrbar. set-stage und clear-all wecken zusätzlich den Dispatcher (pepsi.workqueue trägt keinen benachrichtigenden Trigger, und diese Befehle laufen außerhalb der Schleife des Dispatchers, sodass es sonst nichts täte). Führen Sie ``clear-all`` nur aus, während ``pepsi-dispatch`` gestoppt ist: Die running-Hälfte benennt Datensätze, die ein lebender Worker noch halten könnte, und sie zurückzusetzen bedeutet, dass dieselbe Nachricht zweimal beansprucht und bearbeitet wird.

69.3. Verhältnis zum Dispatcher

pepsi-queue verändert dieselben stage/status/state-Spalten, auf denen der Dispatcher arbeitet; clear-all ergänzt das Zurücksetzen verwaister running-Datensätze, das der Dispatcher beim Start selbst vornimmt. Es startet keine Stage-Programme.

69.4. Siehe auch

pepsi-dispatch, Architektur, pepsi-queue(1), pepsi.conf(5).