78. pepsi-settings¶
Gérer les redéfinitions d’options d’étape par adresse.
78.1. Rôle¶
pepsi-settings est l’outil de l’opérateur pour la table pepsi.settings, qui redéfinit les options [stage-<name>] d’une étape pour les messages vers ou depuis une adresse d’enveloppe particulière (la valeur INI reste la valeur par défaut). Il se connecte via la section partagée [pepsi-postgres] et n’a aucune configuration propre. Le code commun des étapes consulte la table de façon transparente (voir pepsi-dispatch) ; cet outil permet à un administrateur d’éditer les lignes directement. Ce n’est pas une étape. Démarré en tant que root, il lit la configuration et tout fichier d’entrée d”import, puis poursuit sous le compte de service pepsi avant de se connecter ; aucun sudo -u pepsi n’est donc nécessaire. Référence : pepsi-settings(1).
Chaque ligne associe une adresse d’enveloppe en minuscules à un objet JSON { "stage-<name>": { OPTION: value, … } }. L’adresse pertinente est l”expéditeur d’enveloppe pour le courrier d’origine locale (state.local_origin), sinon un destinataire d’enveloppe, mis en correspondance exacte. Lorsque les destinataires d’un message entrant se résolvent en des redéfinitions différentes pour l’étape sur le point de s’exécuter, le pipeline le scinde en une ligne par groupe de redéfinition distinct.
78.2. Fonctionnalités¶
set ADDRESS STAGE OPTION VALUE — définir une redéfinition d’option (le label d’étape est stocké comme clé de section
stage-<name>, qui doit exister dans la configuration ; la valeur est analysée par l’étape comme sa valeur INI).unset ADDRESS STAGE [OPTION] — supprimer une option, ou toute la section d’étape ; les sections et lignes vides sont supprimées automatiquement.
import ADDRESS SOURCE — remplacer l’objet entier d’une adresse à partir d’un fichier JSON (
-pour l’entrée standard).get / list — imprimer les paramètres d’une adresse, ou toutes les lignes (
--json).remove — supprimer entièrement la ligne d’une adresse.
pepsi-setup valide la table après avoir installé le schéma : les clés de premier niveau doivent être de vraies sections [stage-<name>] et les valeurs d’option doivent être des scalaires JSON.
Chaque modification que fait cet outil est écrite dans le journal d’audit (adresse et option, jamais la valeur). Une redéfinition ne peut pas remplacer le PROGRAM, le NEXT_STAGE ou le BOUNCE_STAGE d’une étape, mais elle peut redéfinir toute autre option que lit l’étape, cibles de branchement comprises. Cette table est la couche de la configuration que les utilisateurs peuvent modifier ; sa frontière est décrite dans Les paramètres par adresse sont une frontière de confiance. Un login réattribué à un nouveau propriétaire perd les lignes du propriétaire précédent (Un identifiant de connexion qui change de propriétaire).
78.3. Voir aussi¶
pepsi-dispatch, pepsi-stage-check-whitelist, pepsi-stage-edit-settings, pepsi-setup, Architecture, pepsi-settings(1), pepsi.conf(5).