78. pepsi-settings

Verwaltet adressbezogene Überschreibungen von Stage-Optionen.

78.1. Rolle

pepsi-settings ist das Betreiberwerkzeug 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. Der gemeinsame Stage-Code fragt die Tabelle transparent ab (siehe pepsi-dispatch); mit diesem Werkzeug kann ein Administrator Datensätze direkt bearbeiten. Es ist keine Stage. Als root gestartet, liest es die Konfiguration und eine etwaige import-Eingabedatei und läuft dann als Dienstkonto pepsi weiter, bevor es sich verbindet. Ein sudo -u pepsi ist daher nicht nötig. 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.

78.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.

Jede Änderung, die dieses Werkzeug vornimmt, wird in das Audit-Log geschrieben (Adresse und Option, nie der Wert). Eine Überschreibung kann PROGRAM, NEXT_STAGE oder BOUNCE_STAGE einer Stage nicht ersetzen, aber sie kann jede andere Option überschreiben, die die Stage liest, Verzweigungsziele eingeschlossen. Diese Tabelle ist die Schicht der Konfiguration, in die Benutzer schreiben können; ihre Grenze beschreibt Adressbezogene Einstellungen sind eine Vertrauensgrenze. Ein Login, das einem neuen Inhaber zugewiesen wird, verliert die Datensätze des vorherigen Inhabers (Ein Login, das den Eigentümer wechselt).

78.3. Siehe auch

pepsi-dispatch, pepsi-stage-check-whitelist, pepsi-stage-edit-settings, pepsi-setup, Architektur, pepsi-settings(1), pepsi.conf(5).