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

Procédures

Sauvegarder, déployer, vérifier : une suite d'actions toujours faite dans le même ordre, déclarée une fois dans kantama.yaml et signée d'un seul geste. Formules Équipe et Entreprise.

3 minutesMis à jour le 18 novembre 2026

Une suite, un seul ordre

Une procédure est une liste d'étapes, chacune une action que l'agent connaît déjà (une de vos actions, un déploiement, une sauvegarde…). Vous la préparez, vous relisez toutes les étapes, et vous signez une fois :

  • l'ordre signé porte la liste exacte des étapes et de leurs paramètres, dans l'ordre : personne ne peut ajouter, retirer ou déplacer une étape après votre signature, la signature ne correspondrait plus ;
  • il porte aussi l'empreinte de la procédure telle que l'agent la lit dans son kantama.yaml : si la procédure a changé sur le serveur depuis la préparation, l'agent refuse ;
  • l'agent exécute les étapes l'une après l'autre et s'arrête à la première en échec : les suivantes ne sont pas lancées, et aucune étape n'est rejouée seule sans un nouvel ordre.

La déclarer

Dans le kantama.yaml du projet, sur le serveur :

kantama.yaml
procedures:
  - id: release
    label: Mise en production
    environments: [production]
    steps:
      - action: core.backup.run
        params: {backup: base}
      - action: core.deploy
        params: {service: api}          # le commit se choisit à la préparation
      - action: core.probe.check      # attend que le service réponde
        params: {service: api, timeout: 120}
  • un paramètre écrit dans une étape est fixé : il ne se change pas à la préparation ; les autres se choisissent à ce moment-là ;
  • de 1 à 10 étapes ; ni ce qui touche la confiance de l'agent ou sa politique, ni la pause du projet, ni un lot de variables, ni une action à « montant inhabituel » (elle se vérifie et se signe seule) ;
  • core.probe.check attend que la sonde de santé d'un service réponde, jusqu'au délai donné (60 s par défaut, 10 min au plus) : elle ne change rien sur le serveur.

Toutes les clés : kantama.yaml.

La préparer et la signer

  1. Dans le projet, ouvrez Procédures. Chaque procédure annoncée par l'agent y figure, avec ses étapes et ce qui reste à choisir.
  2. Préparer : choisissez l'environnement et les paramètres libres de chaque étape. Un seul ordre est préparé.
  3. L'écran de confiance montre les étapes relues dans l'ordre lui-même, numérotées, avec leurs paramètres. Le nombre de signatures est celui de l'étape la plus exigeante (deux appareils, plusieurs membres).
  4. Signez. L'agent vérifie, répond par un reçu signé, puis exécute : le déroulé s'affiche en direct, étape par étape, dans le panneau de l'ordre et depuis l'Activité.

Et la politique de l'agent

Chaque étape reste soumise à la politique de l’agent, aux rôles et aux signataires de son action :

  • si la politique interdit une des étapes (gel, hors des heures autorisées, action interdite), l'agent refuse la procédure avant la première étape : jamais de procédure à moitié faite parce que la troisième étape était interdite ;
  • chaque étape est de nouveau jugée au moment où elle démarre : un gel posé pendant la procédure arrête l'étape suivante ;
  • l'écran de confiance prévient avant la signature : « étape 3 sur 3 : refusée par la politique de l'agent… ».

Le résultat

À la fin, l'agent signe un seul résultat, qui détaille chaque étape : réussie, en échec, refusée à son départ, ou non exécutée. L'Activité garde « Procédure exécutée · 3/3 étapes » ou « Procédure arrêtée · arrêt à l'étape 2 », et la page Procédures montre les dernières exécutions, étape par étape.

Plus tard

Avec la formule Entreprise, une procédure peut aussi être planifiée : signée maintenant, exécutée par l'agent à l'heure choisie (toutes ses étapes doivent pouvoir attendre).

Agent à jour

Les procédures demandent une version récente de l'agent (mettre à jour l’agent). Un agent plus ancien refuse l'ordre en entier, sans exécuter la moindre étape ; la console le dit et ne lui en prépare pas.

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

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