68. pepsi-settings¶
Gérer les redéfinitions d’options d’étape par adresse.
68.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. La table est consultée de façon transparente par l’échafaudage d’étape (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 poursuit sous le compte de service pepsi avant de se connecter (après avoir lu la configuration et tout fichier d’entrée d”import), de sorte qu’aucun sudo -u pepsi n’est 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.
68.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.
68.3. Voir aussi¶
pepsi-dispatch, pepsi-stage-check-whitelist, pepsi-stage-edit-settings, pepsi-setup, Architecture, pepsi-settings(1), pepsi.conf(5).
