69. pepsi-queue

Inspecter et réparer la file d’attente des messages.

69.1. Rôle

pepsi-queue est l’outil de diagnostic et de réparation de l’opérateur pour la table pepsi.workqueue. Il se connecte via la section partagée [pepsi-postgres] ; sa seule option propre est [pepsi-queue] QUARANTINE_MAX_AGE_DAYS (lue par gc). Démarré en tant que root, il poursuit sous le compte de service pepsi avant de se connecter, de sorte qu’aucun sudo -u pepsi n’est nécessaire. Référence : pepsi-queue(1).

69.2. Fonctionnalités

  • list — lister les messages en file, ordonnés par workqueue_id, éventuellement en --json (workqueue_id, stage, status, mail_from, subject, received_at, state), avec --limit (100 par défaut), les filtres --stage et --status, un positionnel WORKQUEUE_ID facultatif qui restreint la sortie à un seul message, et --state-only pour imprimer le state JSON complet et non abrégé de chaque message correspondant au lieu du résumé de ligne. --headers/--body écrivent octet pour octet le bloc d’en-têtes et/ou le corps stockés d’un message. list est l’action par défaut, de sorte que son positionnel et ses options sont aussi acceptés nus (pepsi-queue 5, pepsi-queue --state-only 5), mais pas devant une autre sous-commande : ils y ressembleraient à un filtre que cette sous-commande n’applique pas.

  • delete WORKQUEUE_ID — supprimer définitivement un message.

  • set-stage WORKQUEUE_ID STAGE — réaffecter un message à une étape donnée et réinitialiser son status à pending (son state est laissé inchangé) afin que la nouvelle étape le prenne.

  • clear-all — « déblocage » en masse : réinitialiser chaque message running/paused à pending (failed/timeout sont laissés intacts, de même que le courrier retenu à une étape pepsi-stage-quarantine) — la récupération utilisée après un plantage ou une étape calée.

  • quarantine list|show|release|delete — les messages que retient une étape pepsi-stage-quarantine, par jeton : list (--json, --limit) montre quand chacun est arrivé et depuis quand il est retenu, son enveloppe, et qui l’a envoyé en quarantaine et pourquoi (state.quarantine.by et reason) ; show en montre un ; release le rend à son étape, qui le fait suivre vers son RELEASE_STAGE ; delete le supprime après confirmation (--yes dans un script), ce que consigne le journal de courrier facultatif.

  • gc — nettoyer les données expirées. La commande supprime les nonces de preuve d’origine (pepsi.origin_nonce) dont l’expiration est passée et les lignes du cache d’adresses MX (pepsi.dns_address) dont le TTL DNS est passé. Dans le cache de politiques MTA-STS (pepsi.mta_sts_policy), elle rafraîchit chaque politique dont c’est le tour, indépendamment du flux de courrier (RFC 8461 section 10.2), et supprime les politiques dont le max_age est passé sans rafraîchissement réussi. Elle supprime aussi les demandes de confirmation de listes de diffusion consignées (pepsi.list_confirmation) dont la fenêtre est passée, les lignes de liste blanche list-id apprises restées inactives au-delà de leur max_idle, les seconds facteurs mis en place par e-mail et non confirmés à temps (pepsi.otp_pending), et les rapports agrégés DMARC (pepsi.dmarc_report) plus anciens que [pepsi-dmarc-reports] RETAIN_DAYS. La même exécution revérifie chaque login de l’enregistrement d’attribution de logins RFC 7293 contre passwd, de sorte qu’un login qui a changé de propriétaire perd l’état de son propriétaire précédent (Un identifiant de connexion qui change de propriétaire). Enfin, elle met fin aux rétentions à une étape de quarantaine au bout de [pepsi-queue] QUARANTINE_MAX_AGE_DAYS (14 par défaut), à chaque étape que nomme un QUARANTINE_STAGE et à chaque étape pepsi-stage-quarantine dépourvue de son propre MAX_HOLD. Un message expiré rebondit sans son contenu, à deux exceptions près, qui sont abandonnées à la place : la copie d’une contribution de liste destinée à un membre, et un message dont le contenu est issu d’un texte chiffré EnvelopedData S/MIME (AES-CBC) ou n’a pas pu en être ouvert. Un rebond pour ce dernier indiquerait à son expéditeur si le remplissage d’un texte chiffré modifié était valide (Les rebonds et les réponses au courrier chiffré). La commande est destinée à un timer ; le paquet Debian en câble un horaire (pepsi-origin-gc.timer).

delete, set-stage, clear-all et quarantine release/delete sont consignés dans le journal d’audit, comme le sont les mêmes actions effectuées via l’API d’administration.

Les sous-commandes qui modifient agissent immédiatement et ne sont pas réversibles. set-stage et clear-all réveillent en outre le dispatcher (pepsi.workqueue ne porte aucun déclencheur de notification, et celles-ci s’exécutent hors de la boucle propre au dispatcher, de sorte que rien d’autre ne le ferait). N’exécutez ``clear-all`` que pendant que ``pepsi-dispatch`` est arrêté : la moitié running nomme des lignes qu’un worker vivant peut encore détenir, et les réinitialiser signifie que le même message est revendiqué et traité deux fois.

69.3. Relation avec le dispatcher

pepsi-queue manipule les mêmes colonnes stage/status/state sur lesquelles agit le dispatcher ; clear-all complète la réinitialisation, au démarrage, des lignes running orphelines que le dispatcher effectue lui-même. Il ne démarre pas de programmes d’étape.

69.4. Voir aussi

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