Nouveau · l'app mobile, second appareil pour relire et signer chaque ordre
kantamaSe connecterCréer un espace

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.

4 minutesMis à jour le 18 novembre 2026

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 Kantamaimage 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-composeimage, conteneur recréé, redémarrage à la main, variables d'environnement
Fichierschacun 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 inconnuun 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

  1. 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.
  2. Cliquez une dérive : l'état signé et l'état observé par l'agent, côte à côte.
  3. 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.

kantama.yaml
drift:
  scanner:
    tool: trivy
    every: 24h

Agent à 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.

Cette page vous a-t-elle aidé ?Modifier cette page

Les propositions de modification de la documentation ne sont pas encore ouvertes au public.