43. pepsi-stage-discard

Une étape puits pour les déploiements de staging et de test.

43.1. Rôle

pepsi-stage-discard supprime le message au lieu de le relayer, en simulant éventuellement une issue de remise et le DSN qu’elle produirait. Elle permet à un pipeline de staging d’exercer l’ingress, l’authentification et les étapes sans mettre de courrier sur le réseau. Référence : pepsi-stage-discard(1).

43.2. Fonctionnalités

  • Puits terminal : supprime la ligne et rapporte un succès ; ignore ``NEXT_STAGE``.

  • Disposition simulée : DISPOSITION = success (par défaut) traite le message comme remis ; failure le traite comme un échec de remise permanent.

  • Simulation de DSN facultative (BOUNCE = yes), honorant les préférences DSN de l’expéditeur exactement comme le ferait une vraie étape de remise :

    • failure → achemine vers BOUNCE_STAGE pour un rebond d’échec, mais seulement si NOTIFY demande FAILURE (valeur par défaut en son absence) ; NOTIFY=NEVER abandonne.

    • success → un rapport positif (Action: delivered) seulement lorsque l’option globale ORIGINATE_SUCCESS_DSN est activée et que NOTIFY=SUCCESS a été demandé.

  • Ne fait jamais rebondir un rebond : un message à expéditeur nul est simplement supprimé.

  • Lorsqu’aucun DSN n’est justifié, la ligne est simplement supprimée.

43.3. Configuration

[stage-<name>] : PROGRAM = pepsi-stage-discard, DISPOSITION (success/failure, par défaut success), BOUNCE (yes/no, par défaut no) et BOUNCE_STAGE (l’étape de génération du DSN ; si aucune n’est réglée, rien n’est signalé et la ligne est simplement supprimée). Consulte l’option partagée [pepsi] ORIGINATE_SUCCESS_DSN pour le chemin de succès. Voir pepsi-stage-discard(1).

43.4. État

  • Entrées : state.dsn — les notify/orcpt de chaque destinataire et l”envid au niveau du message. La RFC 3461 fait de NOTIFY une propriété par destinataire ; l’étape décide donc destinataire par destinataire et émet un clone de DSN pour chacun de ceux qui en ont demandé un.

  • Sorties : sur un rejet rapportable, un objet state.bounce (permanent/success) à l’intention de l’étape de rebond ; sinon la ligne (et son state) est supprimée.

43.5. Voir aussi

pepsi-stage-bounce, pepsi-stage-relay-to-internet, Fonctionnalités prises en charge, pepsi-stage-discard(1).