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--stageet--status, un positionnel WORKQUEUE_ID facultatif qui restreint la sortie à un seul message, et--state-onlypour imprimer lestateJSON 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.listest 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(sonstateest laissé inchangé) afin que la nouvelle étape le prenne.clear-all — « déblocage » en masse : réinitialiser chaque message
running/pausedàpending(failed/timeoutsont 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.byetreason) ;showen montre un ;releasele rend à son étape, qui le fait suivre vers sonRELEASE_STAGE;deletele supprime après confirmation (--yesdans 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 lemax_ageest 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 blanchelist-idapprises restées inactives au-delà de leurmax_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 unQUARANTINE_STAGEet à chaque étape pepsi-stage-quarantine dépourvue de son propreMAX_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éEnvelopedDataS/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).