Dérive
Savoir quand un serveur a été modifié à la main, hors de Kantama : l'agent compare l'état réel à l'état laissé par le dernier ordre signé, et signe chaque écart. Toutes les formules.
Ce que l'agent compare
Toutes les 10 minutes, l'agent regarde son serveur et le compare à sa référence : l'état laissé par le dernier ordre signé qu'il a exécuté.
| Sujet | Écart signalé |
|---|---|
| Service déployé par Kantama | image différente de celle du dernier déploiement signé, conteneur remplacé, arrêté ou retiré, redémarré à la main, variables d'environnement changées |
| Service de votre docker-compose | image, conteneur recréé, redémarrage à la main, variables d'environnement |
| Fichiers | chacun de vos fichiers docker-compose, kantama.yaml, les variables écrites par l'agent, sa liste de confiance et sa politique, modifiés sans ordre signé ; un fichier docker-compose ajouté à kantama.yaml (ou retiré) est montré avec lui et accepté en même temps |
| Conteneur inconnu | un conteneur au nom du projet que l'agent n'a mis en place par aucun ordre |
La référence ne change que par un ordre signé : un déploiement, un retour en arrière, un redémarrage ou un lot de variables exécutés par l'agent la mettent à jour, pour ce qu'ils changent et seulement pour cela. La toute première est l'état du serveur au premier passage de l'agent.
Ce qui n'est pas une dérive
- un conteneur relancé par Docker lui-même (politique
restart), ou au redémarrage du serveur ; - les prévisualisations par branche, mises en ligne et retirées par l'agent ;
- une commande ponctuelle (
docker compose run) ; - un état passager : un écart nouveau est revu 30 secondes plus tard, et rien n'est regardé pendant qu'un ordre s'exécute.
Un redémarrage du démon Docker sans redémarrage du serveur est signalé comme un redémarrage à la main : acceptez-le si c'était vous.
Un écart signé, une alerte
Chaque écart part au serveur central dans un avis signé par l'agent, puis un second à sa fin. Le central ne peut ni en inventer un, ni en effacer un : l'avis signé est gardé tel quel, son empreinte est au journal chaîné.
- une alerte s'ouvre, et se résout d'elle-même à la fin de la dérive ;
- elle est en panne si la liste de confiance ou la politique de l'agent a changé : ce sont elles qui décident de ce que l'agent accepte ;
- à chaque passage, l'agent signe aussi une attestation de ce qu'il a regardé : elle prouve qu'aucune dérive n'était ouverte.
L'écran Dérive
- Dans le projet, ouvrez Dérive : l'heure du dernier passage, l'attestation de l'agent, et les dérives ouvertes. Vérifier maintenant demande un passage sans attendre.
- Cliquez une dérive : l'état signé et l'état observé par l'agent, côte à côte.
- La vue d'ensemble de l'espace montre, pour chaque projet, combien de dérives sont ouvertes.
Reprendre l'état signé
Pour un service déployé par Kantama, Reprendre l'état signé prépare le redéploiement du commit du dernier déploiement signé. Comme tout ordre, vous le relisez et le signez ; rien ne part sans signature. Une fois exécuté, la dérive se ferme, et l'Activité dit qu'elle l'a été par cet ordre.
Pour un fichier ou un service de votre docker-compose, Kantama n'a pas de version signée à remettre : corrigez sur le serveur (la dérive se ferme d'elle-même au passage suivant), ou acceptez l'état observé.
Accepter comme nouvelle référence
Si le changement était voulu, cochez les dérives et choisissez Accepter comme nouvelle référence : un ordre signé à deux appareils (il légitime un état que personne n'avait signé).
- l'ordre désigne chaque dérive et l'empreinte de l'état que vous voyez : si l'état a encore changé depuis votre relecture, l'agent refuse ;
- rien n'est changé sur le serveur : l'agent prend cet état comme référence, et signe la fin de la dérive ;
- il se signe par le propriétaire ou un membre qui signe dans tous les environnements, comme ce qui touche la confiance de l'agent.
Images et vulnérabilités
L'écran montre aussi chaque image en service : son identifiant, sa date de construction, son système de base (lu sans réseau, sans rien exécuter ; vide s'il n'y en a pas).
Kantama ne télécharge aucune base de vulnérabilités. Si trivy ou grype est déjà installé sur le serveur, avec sa base, déclarez-le dans kantama.yaml : l'agent l'appelle hors ligne, une image à la fois, et l'écran montre le nombre de vulnérabilités par gravité. Sans outil, ou sans base, rien n'est analysé, et l'écran le dit.
drift:
scanner:
tool: trivy
every: 24hAgent à jour
La dérive demande une version récente de l'agent (mettre à jour l’agent). Un agent plus ancien ne surveille rien : la console le dit.
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.