93. pepsi-config

Inspecter et modifier la configuration effective partagée par tous les composants.

93.1. Rôle

pepsi-config consulte, développe, affiche et modifie la configuration Pepsi fusionnée. Chaque composant lit le même fichier de configuration au format INI et la même surcouche en base de données (pepsi.config_override), de sorte qu’un seul outil les sert tous et qu’aucun autre binaire n’a de sous-commande config. C’est une CLI d’opérateur, pas une étape. Référence : pepsi-config(1).

Les commandes de lecture affichent la configuration effective : le fichier amendé par la surcouche. Une base de données injoignable n’est pas une erreur : la configuration du fichier est alors affichée avec un avertissement, car c’est souvent précisément quand la base de données est injoignable qu’un opérateur se sert de cet outil. Les commandes d’écriture ne modifient que la surcouche ; elles ne touchent jamais au fichier de configuration, qui reste celui de l’opérateur. Les écritures se connectent sous le rôle PostgreSQL pepsi-config (adopté automatiquement quand le programme démarre en root). Qui peut modifier la configuration dépend donc d’une autorisation dans la base de données, et non d’un contrôle dans ce programme.

93.2. Fonctionnalités

  • get SECTION OPTION — imprimer la valeur d’une option dans une section ; avec --filename la valeur est traitée comme un chemin et subit l’expansion $.

  • pathsub PATH_EXPR — substituer les marqueurs ${VAR}/$VAR dans une expression de chemin depuis la section [PATHS] et l’environnement.

  • dump — imprimer la configuration fusionnée ; --diagnostics y ajoute la sortie supplémentaire de l’analyseur, --origin annote chaque valeur avec la couche dont elle provient (file, ou la portée de base de données qui l’a posée en dernier) et --scope résout la chaîne pour une portée autre que global.

  • set SECTION OPTION VALUE / unset SECTION [OPTION] — écrire ou retirer une surcharge (ou, pour unset sans option, une section entière) dans la surcouche en base de données à la portée --scope (global par défaut, ou domain:<d> ou address:<a>). Les sections lues depuis le seul fichier sont refusées.

  • list — imprimer les surcharges stockées, éventuellement restreintes par --scope et en incluant les lignes préparées avec --drafts.

  • export FICHIER / import FICHIER — écrire et restaurer une archive chiffrée par mot de passe du répertoire de configuration (- pour l’entrée/sortie standard ; --from/--into choisissent le répertoire, --password-file évite la question, --force écrase les fichiers existants). C’est la moitié d’une sauvegarde que les outils propres à PostgreSQL ne peuvent pas couvrir : le fichier de configuration et les fragments secrets.d.

Les valeurs qui sont des secrets sont masquées dans la sortie de dump, de sorte qu’un dump peut être joint à un rapport de bogue. Un set proposé est validé avant d’être stocké : le programme construit la configuration que le changement produirait et y applique l’analyseur de l’étape concernée. Une valeur qui empêcherait un programme de démarrer est refusée plutôt qu’écrite. La surcouche ne nomme jamais un exécutable : HELPER, SCAN_HELPER, MAILBOX_HELPER, PIN_COMMAND et tout PROGRAM qui n’est pas une simple commande pepsi-stage-* sont refusés, de même que les options porteuses d’identifiants, qui ne résident jamais que dans des fragments secrets.d. Un attaquant qui a le fichier de configuration explique pourquoi le fichier est lisible par tous et pourquoi y avoir accès en écriture équivaut à être root ; Un attaquant qui a la base de données explique qui peut modifier la surcouche.

export exige un mot de passe d’au moins 12 caractères : l’archive contient chaque fragment secret, clé de chiffrement des clés comprise, et peut être attaquée hors ligne (Argon2id ralentit une telle attaque, mais ne l’empêche pas).

93.3. Validation

pepsi-config dump s’associe au check de pepsi-setup(1) lors de la validation d’une installation : check interroge le DNS en service, tandis que dump montre les valeurs effectives que les composants verront réellement.

93.4. Voir aussi

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