62. pepsi-stage-quarantine¶
Retient un message jusqu’à ce qu’un opérateur le libère ou le supprime.
62.1. Rôle¶
pepsi-stage-quarantine est l’endroit où attend le courrier mis en quarantaine. Une demande de quarantaine d’un milter (QUARANTINE_STAGE de pepsi-stage-milter, ou un milter pré-file dans pepsi-ingress), QUARANTINE_STAGE de pepsi-stage-decrypt ou tout autre acheminement peut y envoyer un message. L’étape le retient jusqu’à ce qu’un opérateur agisse avec pepsi-queue quarantine, et n’envoie aucun avis de son propre chef. Comme la quarantaine est une étape, un site peut mettre un autre gestionnaire à sa place. Référence : pepsi-stage-quarantine(1).
62.2. Fonctionnalités¶
Retenu sans minuterie : à l’arrivée, l’étape note
state.quarantine.sinceet laisse la lignepausedsanstimeout, de sorte que pepsi-dispatch ne la réveille jamais de lui-même.Libéré par un opérateur :
pepsi-queue quarantine release TOKENrend la ligne à l’étape, qui notereleased_atet fait suivre le message versRELEASE_STAGE.pepsi-queue quarantine delete TOKENle supprime (noté dans le journal de courrier, s’il est activé). Le webhook de paiement (POST /resumede pepsi-httpd) ne touche pas à un message retenu.Une fin facultative : avec
MAX_HOLD(par exemple14 days), la rétention prend fin d’elle-même ; le message va alors àEXPIRE_STAGE, marqué commepepsi-queue gcmarque une quarantaine expirée (failure_class = quarantine-expired, seul le bloc d’en-têtes dans une DSN), ou il est supprimé. SansMAX_HOLD,pepsi-queue gcgénère un rebond pour un message encore retenu[pepsi-queue] QUARANTINE_MAX_AGE_DAYS(14) jours après son arrivée, comme à toute étape de quarantaine, car le courrier retenu est stocké en clair.Pas d’oracle à la fin : la copie d’une contribution de liste destinée à un membre, et un message dont le contenu provient d’un texte chiffré sans protection d’intégrité, sont supprimés à l’expiration au lieu d’être acheminés (Les rebonds et les réponses au courrier chiffré).
Retenu à nouveau après une libération : un message qui revient à une étape de quarantaine après une libération antérieure commence une nouvelle rétention.
Pas laissé aux correspondants : les options sont lues depuis la configuration de base, jamais depuis les paramètres par adresse.
62.3. Configuration¶
[stage-<name>] : PROGRAM = pepsi-stage-quarantine, RELEASE_STAGE (par défaut NEXT_STAGE ; l’une des deux est obligatoire), MAX_HOLD (un intervalle ; un jour compte pour 24 heures) et EXPIRE_STAGE (nécessite MAX_HOLD). Un message que l’ingress a mis en quarantaine a sauté toutes les étapes précédant celle-ci ; pour cet usage, RELEASE_STAGE vaut donc normalement init. pepsi-setup validate et la vérification de démarrage du worker refusent une cible qui n’existe pas ou qui est l’étape elle-même.
62.4. État¶
Entrées :
state.quarantine.reasonetby, écrits par celui qui a envoyé le message ici.Sorties :
state.quarantine:since,until(avecMAX_HOLD),released_atouexpired(pepsi.state(7)).
62.5. Voir aussi¶
pepsi-queue, pepsi-stage-milter, Exploiter Pepsi, pepsi-stage-quarantine(1).