88. pepsi-failure-bouncer¶
Canaliser les messages en échec ou en timeout vers l’étape de rebond.
88.1. Rôle¶
Lorsque son étape abandonne, un message du pipeline post-ingress finit en failed ou en timeout. Il est failed quand une étape a renvoyé une erreur permanente, qu’une erreur a survécu à MAX_LIFETIME à une étape sans BOUNCE_STAGE, que le message a fait planter son worker trois fois, ou qu’il attendait à une étape que la configuration ne nomme plus. Il est timeout quand il a retenu son worker au-delà de MAX_RUNTIME trois fois ou, dans une étape pepsi-stage-relay-to-*, qu’il était encore tué à MAX_LIFETIME. Le dispatcher ne remet jamais une telle ligne en file, de sorte que sans intervention de l’opérateur le message reste bloqué dans pepsi.workqueue et l’expéditeur n’est jamais notifié.
pepsi-failure-bouncer déplace chaque message bloqué vers le [pepsi-failure-bouncer] BOUNCE_STAGE configuré et le remet à pending. Le dispatcher exécute alors l’étape de rebond (pepsi-stage-bounce), qui émet une notification d’état de remise comme le demande le NOTIFY RFC 3461 de l’expéditeur. Un message déjà à l’étape de rebond est laissé intact, de sorte qu’un rebond qui échoue à cette étape ne boucle pas ; un rebond qui échoue en aval (un DSN à expéditeur nul non relayable) est ramené en arrière et simplement abandonné (un rebond ne rebondit jamais une seconde fois). BOUNCE_STAGE doit donc mener à une véritable étape de rebond : pepsi-setup refuse un BOUNCE_STAGE qui ne nomme aucune étape et avertit au sujet d’un BOUNCE_STAGE qui n’exécute pas directement pepsi-stage-bounce.
Il attend d’abord : un message n’est déplacé qu’une fois qu’il est en échec depuis MIN_AGE (une heure par défaut, comptée à partir de state.failed_at, que la base de données horodate). L’opérateur a ainsi le temps de le remettre en place avec pepsi-queue. Chaque message qu’il déplace est journalisé comme avertissement avec son expéditeur, l’étape à laquelle il a échoué et l’erreur consignée, que l’étape de rebond ne copie pas dans le DSN ; l’étape est conservée dans state.failed_stage. La copie d’une contribution de liste destinée à un membre (une ligne portant state.list.member) est au contraire supprimée : son expéditeur d’enveloppe est l’adresse de rebond propre à la liste, de sorte qu’un DSN imputerait au membre la faute de cet hôte. Une contribution en route vers une liste a pour expéditeur d’enveloppe son auteur et rebondit comme tout autre message. Un message dont le contenu est issu d’un EnvelopedData S/MIME, ou n’a pas pu en être ouvert, est lui aussi supprimé (télémétrie decrypt-dropped) : un DSN indiquerait à un expéditeur qui a modifié le texte chiffré CBC si son remplissage était valide (Oracles de remplissage et de format CBC contre S/MIME non authentifié). Après avoir déplacé des lignes, il réveille lui-même le dispatcher.
Il se connecte via [pepsi-postgres] et est configuré par [pepsi-failure-bouncer] : BOUNCE_STAGE (obligatoire, l’étape vers laquelle les messages bloqués sont déplacés) et MIN_AGE. Ce n’est pas une étape. Démarré en tant que root, il passe au compte de service pepsi, le rôle qui possède la file d’attente, avant de se connecter. Référence : pepsi-failure-bouncer(1).
88.2. Modes¶
service (par défaut, sans
--once) — un processus de longue durée qui fait unLISTENsur le canalworkqueue_failed(émis par le déclencheurworkqueue_failed_notifychaque fois qu’une ligne passe en failed ou timeout) et fait rebondir chaque message une fois qu’il a atteint l’âgeMIN_AGE, en se réveillant pour l’échec en attente le plus ancien lorsqu’aucune notification n’arrive avant. Il balaie au démarrage et à chaque reconnexion tous les messages déjà bloqués, de sorte que rien n’est manqué, et s’exécute jusqu’àSIGINT/SIGTERM. Aucune unité livrée n’exécute ce mode.–once — balayer une seule fois les messages actuellement bloqués et quitter. C’est ce qu’exécute
pepsi-failure-bouncer.timer, sous le comptepepsi, toutes les dix minutes ;pepsi.targetrequiert le timer. Un hôte de test qui veut conserver les messages en échec pour diagnostic le masque (systemctl mask --now pepsi-failure-bouncer.timer), puisque la cible redémarrerait un timer simplement désactivé.
--failed-only / --timeout-only restreignent l’un ou l’autre mode à l’un des deux états terminaux.
La raison pour laquelle un échec ne peut pas boucler à travers l’étape de rebond fait partie de l’analyse de disponibilité (Disponibilité) ; les DSN que l’étape de rebond retient ensuite sont décrits sous pepsi-stage-bounce.
88.3. Voir aussi¶
pepsi-dispatch, pepsi-stage-bounce, pepsi-queue, pepsi-status, pepsi-failure-bouncer(1), pepsi.conf(5).