68. pepsi-settings¶
Verwaltet adressbezogene Überschreibungen von Stage-Optionen.
68.1. Rolle¶
pepsi-settings ist das Operator-Werkzeug für die pepsi.settings-Tabelle, die die [stage-<name>]-Optionen einer Stage für Nachrichten an oder von einer bestimmten Umschlagadresse überschreibt (der INI-Wert bleibt der Standardwert). Es verbindet sich über den gemeinsamen [pepsi-postgres]-Abschnitt und hat keine eigene Konfiguration. Die Tabelle wird vom Stage-Gerüst transparent abgefragt (siehe pepsi-dispatch); dieses Werkzeug erlaubt einem Administrator, Datensätze direkt zu bearbeiten. Es ist keine Stage. Als root gestartet, läuft es vor dem Verbinden als Dienstkonto pepsi weiter (nachdem die Konfiguration und eine etwaige import-Eingabedatei gelesen wurden), sodass kein sudo -u pepsi nötig ist. Referenz: pepsi-settings(1).
Jeder Datensatz bildet eine kleingeschriebene Umschlagadresse auf ein JSON-Objekt { "stage-<name>": { OPTION: value, … } } ab. Die relevante Adresse ist der Umschlag-Absender für lokal erzeugte Mail (state.local_origin), sonst ein Umschlag-Empfänger, exakt abgeglichen. Wenn die Empfänger einer eingehenden Nachricht auf unterschiedliche Überschreibungen für die als Nächstes laufende Stage auflösen, teilt die Pipeline sie in je einen Datensatz pro unterschiedlicher Überschreibungsgruppe auf.
68.2. Funktionen¶
set ADDRESS STAGE OPTION VALUE — setzt eine Optionsüberschreibung (die Stage-Bezeichnung wird als Abschnittsschlüssel
stage-<name>gespeichert, der in der Konfiguration existieren muss; der Wert wird von der Stage wie ihr INI-Wert geparst).unset ADDRESS STAGE [OPTION] — entfernt eine Option oder den ganzen Stage-Abschnitt; leere Abschnitte und Datensätze werden automatisch verworfen.
import ADDRESS SOURCE — ersetzt das ganze Objekt einer Adresse aus einer JSON-Datei (
-für die Standardeingabe).get / list — gibt die Einstellungen einer Adresse oder alle Datensätze aus (
--json).remove — löscht den Datensatz einer Adresse vollständig.
pepsi-setup validiert die Tabelle nach der Installation des Schemas: Schlüssel der obersten Ebene müssen echte [stage-<name>]-Abschnitte sein und Optionswerte müssen JSON-Skalare sein.
68.3. Siehe auch¶
pepsi-dispatch, pepsi-stage-check-whitelist, pepsi-stage-edit-settings, pepsi-setup, Architektur, pepsi-settings(1), pepsi.conf(5).
