93. pepsi-config

Inspiziert und bearbeitet die effektive Konfiguration, die von jeder Komponente gemeinsam genutzt wird.

93.1. Rolle

pepsi-config schlägt die zusammengeführte Pepsi-Konfiguration nach, expandiert sie, gibt sie aus und bearbeitet sie. Jede Komponente liest dieselbe Konfigurationsdatei im INI-Stil und dieselbe Datenbank-Überlagerung (pepsi.config_override), sodass ein einziges Werkzeug allen dient und kein anderes Binärprogramm einen config-Unterbefehl hat. Es ist ein Betreiber-CLI, keine Stage. Referenz: pepsi-config(1).

Die Lesebefehle zeigen die effektive Konfiguration: die Datei, ergänzt um die Überlagerung. Eine nicht erreichbare Datenbank ist kein Fehler: Stattdessen wird die Konfiguration der Datei mit einer Warnung gezeigt, denn gerade wenn die Datenbank nicht erreichbar ist, greift ein Betreiber oft zu diesem Werkzeug. Die Schreibbefehle bearbeiten allein die Überlagerung; sie rühren die Konfigurationsdatei nie an, die dem Betreiber gehört. Schreibvorgänge verbinden sich als PostgreSQL-Rolle pepsi-config (das Programm übernimmt sie automatisch, wenn es als root gestartet wird). Wer die Konfiguration bearbeiten darf, regelt also eine Berechtigung in der Datenbank und keine Prüfung in diesem Programm.

93.2. Funktionen

  • get SECTION OPTION — gibt den Wert einer Option in einem Abschnitt aus; mit --filename wird der Wert als Pfad behandelt und $-expandiert.

  • pathsub PATH_EXPR — ersetzt ${VAR}/$VAR-Platzhalter in einem Pfadausdruck aus dem [PATHS]-Abschnitt und der Umgebung.

  • dump — gibt die zusammengeführte Konfiguration aus; --diagnostics ergänzt die zusätzliche Ausgabe des Parsers, --origin versieht jeden Wert mit der Schicht, aus der er stammt (file oder der Datenbank-Geltungsbereich, der ihn zuletzt gesetzt hat), und --scope löst die Kette für einen anderen Geltungsbereich als global auf.

  • set SECTION OPTION VALUE / unset SECTION [OPTION] — schreibt oder entfernt eine Überschreibung (oder, bei unset ohne Option, einen ganzen Abschnitt) in der Datenbank-Überlagerung im Geltungsbereich von --scope (standardmäßig global, sonst domain:<d> oder address:<a>). Abschnitte, die nur aus der Datei gelesen werden, werden abgelehnt.

  • list — gibt die gespeicherten Überschreibungen aus, wahlweise mit --scope eingeschränkt und mit --drafts einschließlich der vorbereiteten Datensätze.

  • export FILE / import FILE — schreibt ein passwortverschlüsseltes Archiv des Konfigurationsverzeichnisses und stellt es wieder her (- für die Standardausgabe/-eingabe; --from/--into wählen das Verzeichnis, --password-file vermeidet die Eingabeaufforderung, --force überschreibt vorhandene Dateien). Dies ist die Hälfte einer Sicherung, die PostgreSQLs eigene Werkzeuge nicht abdecken können: die Konfigurationsdatei und die secrets.d-Fragmente.

Werte, die Geheimnisse sind, werden in der Ausgabe von dump maskiert, sodass man einen Dump einem Fehlerbericht beilegen kann. Ein vorgeschlagenes set wird vor dem Speichern geprüft: Das Programm baut die Konfiguration, die die Änderung ergäbe, und lässt den Parser der zuständigen Stage darüber laufen. Ein Wert, der ein Programm am Starten hindern würde, wird abgelehnt statt geschrieben. Die Überlagerung benennt nie ein ausführbares Programm: HELPER, SCAN_HELPER, MAILBOX_HELPER, PIN_COMMAND und jedes PROGRAM, das kein bloßer pepsi-stage-*-Befehl ist, werden abgelehnt, ebenso Optionen mit Zugangsdaten, die nur in secrets.d-Fragmenten liegen. Ein Angreifer, der die Konfigurationsdatei hat erklärt, warum die Datei für alle lesbar ist und warum Schreibzugriff darauf root-Rechten gleichkommt; Ein Angreifer, der die Datenbank hat erklärt, wer die Überlagerung bearbeiten darf.

export verlangt ein Passwort von mindestens 12 Zeichen: Das Archiv enthält jedes Geheimnis-Fragment, auch den Schlüssel, der die anderen Schlüssel verschlüsselt, und kann offline angegriffen werden (Argon2id verlangsamt einen solchen Angriff, verhindert ihn aber nicht).

93.3. Validierung

pepsi-config dump ergänzt das check von pepsi-setup(1) beim Validieren einer Installation: check fragt Live-DNS ab, während dump die effektiven Werte zeigt, die die Komponenten tatsächlich sehen werden.

93.4. Siehe auch

pepsi-setup, Konfiguration, pepsi-config(1), pepsi.conf(5).