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
--filenamewird 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;
--diagnosticsergänzt die zusätzliche Ausgabe des Parsers,--originversieht jeden Wert mit der Schicht, aus der er stammt (fileoder der Datenbank-Geltungsbereich, der ihn zuletzt gesetzt hat), und--scopelöst die Kette für einen anderen Geltungsbereich alsglobalauf.set SECTION OPTION VALUE / unset SECTION [OPTION] — schreibt oder entfernt eine Überschreibung (oder, bei
unsetohne Option, einen ganzen Abschnitt) in der Datenbank-Überlagerung im Geltungsbereich von--scope(standardmäßigglobal, sonstdomain:<d>oderaddress:<a>). Abschnitte, die nur aus der Datei gelesen werden, werden abgelehnt.list — gibt die gespeicherten Überschreibungen aus, wahlweise mit
--scopeeingeschränkt und mit--draftseinschließ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/--intowählen das Verzeichnis,--password-filevermeidet die Eingabeaufforderung,--forceüberschreibt vorhandene Dateien). Dies ist die Hälfte einer Sicherung, die PostgreSQLs eigene Werkzeuge nicht abdecken können: die Konfigurationsdatei und diesecrets.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.