Fichiers de configuration
Lire un fichier de configuration du serveur, valeurs sensibles masquées, et le modifier par un ordre signé : l'agent l'écrit, le teste et le recharge, et remet l'ancien contenu si le test échoue.
Déclarer un fichier
Seuls les fichiers déclarés dans kantama.yaml sont lus ou modifiés. Pour pouvoir modifier un fichier, déclarez aussi la commande qui le teste et, si besoin, celle qui le recharge ; chacune s'exécute dans un service, comme une action, sans shell :
['config_files:', ' - id: securite', ' label: En-têtes de sécurité (nginx)', ' path: /opt/boutique/infra/nginx/securite.conf', ' env: production', ' test: {service: nginx, command: [nginx, -t]}', ' reload: {service: nginx, command: [nginx, -s, reload]}', ' # Sans test : le fichier se lit, il ne se modifie pas.', ' - {id: geo, label: Plages autorisées, path: /opt/boutique/infra/nginx/geo.conf}']Un chemin absolu vers un fichier ordinaire de 64 Kio au plus : l'agent ne suit jamais un lien et ne touche ni à un dossier ni à un fichier spécial. Vingt fichiers au plus par projet.
Lire
La page Fichiers du projet liste les fichiers déclarés, avec leur taille, leur date et leur empreinte. Lire demande le contenu à l'agent : il le lit lui-même et masque, avant de l'envoyer, ce qui ressemble à un secret (mot de passe, jeton, clé privée) et les valeurs des variables qu'il connaît. Le contenu n'est jamais gardé par le serveur central ; le journal dit qui a lu quel fichier, sans son contenu.
Un contenu où l'agent a masqué quelque chose se lit seulement : réécrire le signe de masquage à la place du secret casserait la configuration, et l'agent le refuse.
Modifier
Modifier ouvre le contenu lu dans un éditeur ; les lignes changées s'affichent au fur et à mesure. Préparer la modification crée l'ordre : le nouveau contenu y est joint, et l'ordre signe son empreinte et celle du contenu que vous avez lu. Dans le tiroir, la console recalcule l'empreinte du contenu joint avant de vous laisser signer. En production, il faut deux appareils.
L'agent, ensuite :
- refuse tout de suite un contenu qui n'est pas celui signé, ou un fichier modifié depuis votre lecture : rien n'est écrit ;
- garde une copie de l'ancien contenu sur le serveur ;
- écrit le nouveau contenu à la place de l'ancien, dans le même fichier : un conteneur qui le monte seul le voit aussitôt ;
- lance la commande de test : si elle refuse, il remet l'ancien contenu et ne recharge rien ;
- lance la commande de rechargement : si elle échoue, il remet l'ancien contenu et le recharge ;
- signe un résultat qui dit l'empreinte avant, voulue et après, la sortie des deux commandes et si l'ancien contenu a été remis.
Fichier suivi par Git
Si le fichier se trouve dans le clone de travail d'un projet déployé par Kantama, la page le signale : une modification faite ici laisse le dépôt du serveur « modifié », et le déploiement suivant le refusera tant qu'elle n'est pas commitée dans votre dépôt. C'est voulu : un déploiement n'écrase jamais une modification locale en silence.
Ce qui est garanti
Modifier un fichier n'est pas un geste de secours : un gel de production ou une plage horaire l'arrête. L'ordre ne se signe ni en différé ni dans une procédure, car il vise un contenu précis du fichier. Un agent qui ne connaît pas les fichiers de configuration refuse le manifeste et l'ordre.
Formule
| Solo | Équipe | Entreprise | |
|---|---|---|---|
| Lire un fichier de configuration | oui | oui | oui |
| Modifier par ordre signé, testé avant d'être gardé | oui | oui |
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.