CLI kantama
Le binaire kantama n'a qu'une famille de commandes : kantama agent …, l'agent installé sur chaque serveur.
Installer le binaire
curl -fsSL https://kantama.app/installer.sh | sh kantama agent version
Téléchargement manuel et vérification de l'empreinte (Linux, Windows) : voir Démarrer, étape 2.
Commandes
| Commande | Options | Effet |
|---|---|---|
init | [--dossier D] | crée l'identité de l'agent (jamais écrasée) |
empreinte | [--dossier D] | affiche l'empreinte à comparer lors de l'enrôlement |
enroler | --central URL --code CODE [--dossier D] [--manifeste kantama.yaml]--central URL --reprendre agt_… [--dossier D] | rattache ce serveur à votre espace (code à usage unique) ; --reprendre reprend, avec la même identité et sans nouveau code, un enrôlement interrompu |
connecter | --central URL --manifeste FICHIER [--dossier D] … | connexion sortante : reçoit les ordres, renvoie des reçus signés |
appliquer | FICHIER --manifeste kantama.yaml [--dossier D] [--recu CHEMIN] | serveur coupé du central : vérifie et exécute un ordre signé en différé, remis par fichier, et écrit son reçu signé (mode hors ligne) |
confiance | [--dossier D] | liste les passkeys de confiance |
politique | [--dossier D] | affiche la politique de l'agent (gels, plages horaires, règles) |
manifeste | FICHIER | valide un kantama.yaml et affiche la liste fermée, puis chaque procédure et son empreinte |
version | affiche la version du binaire |
Sans argument, ou avec une commande inconnue, kantama affiche cette aide et sort avec le code 2. Une erreur sort avec le code 1.
enroler
Crée l'identité si besoin, affiche l'empreinte groupée par 4, puis attend votre approbation dans la console. Avec --manifeste, l'agent joint un résumé de kantama.yaml aux vérifications affichées dans la console (horloge, binaire, Docker, conteneurs).
kantama agent enroler --central https://kantama.app --code K7Q-4M2-XP9 --manifeste kantama.yaml
connecter et ses options
Refuse de démarrer sans passkey de confiance (« l'agent refuserait tout ordre »), ou si --central n'est pas le central de l'enrôlement.
| Option | Défaut | Rôle |
|---|---|---|
--dossier | /var/lib/kantama-agent (Linux) | dossier d'état de l'agent |
--port-http, --port-https | 80, 443 | ports publiés par kantama-proxy (0 : pas de HTTPS) |
--sondes | 30s | intervalle des sondes de santé, 0 pour aucune |
--certificats | public | public (domaine:443) ou local (kamal-proxy de ce serveur) |
--certificats-intervalle | 6h | intervalle de relevé des certificats |
--sauvegardes | 30s | vérification du planning des sauvegardes, 0 pour sur ordre seulement |
--mesures | 30s | relevé des conteneurs du projet, 0 pour aucun |
--dns | 10m | résolution des enregistrements DNS attendus, 0 pour « Actualiser » seulement |
--securite | 10m | relevé de la sécurité de l'hôte (mises à jour, redémarrage requis, SSH, pare-feu), 0 pour aucun |
--hote-racine | / | racine de l'hôte pour lire processeur, mémoire et disques du serveur ; /host pour un agent en conteneur |
--connecteurs | 5m | lecture des plateformes, 0 pour sur demande seulement |
--surveillance | 1m | retrait des prévisualisations échues |
--derive | 10m | comparaison de l'état réel à l'état signé (Dérive), 0 pour aucune |
--derive-confirmation | 30s | délai avant de confirmer un écart nouveau (un état passager n'est pas signalé) |
--proxy-nom, --reseau | kantama-proxy, kantama | conteneur kamal-proxy et réseau Docker |
kantama agent connecter --central https://kantama.app --manifeste kantama.yaml --sondes 30s --certificats public
Contrôler sans rien changer
kantama agent empreinte # à comparer avec la console kantama agent confiance # passkeys acceptées par cet agent kantama agent manifeste kantama.yaml
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.