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

Interrupteurs

Mettre le site en maintenance, couper les paiements, fermer les inscriptions : d'un geste signé, et voir l'état réel de chaque interrupteur, lu par l'agent. Toutes les formules.

2 minutesMis à jour le 18 novembre 2026

Déclarer un interrupteur

Un interrupteur est un réglage à deux états, déclaré dans kantama.yaml sous l'une de deux formes :

kantama.yaml
['switches:', '  # Fichier témoin : présent = activé. Votre nginx (ou votre application) le teste.', '  - id: maintenance', '    label: Site en maintenance', '    environments: [production]', '    file: /var/lib/boutique-urgence/maintenance', "  # Deux actions déclarées et une commande qui lit l'état.", '  - id: inscriptions', '    label: Inscriptions fermées', '    on: inscriptions.fermer', '    off: inscriptions.ouvrir', '    state: {service: api, command: [python, -m, app.ops, etat-inscriptions]}']
  • fichier témoin : l'agent crée un fichier vide ou le retire, rien d'autre. Le dossier doit déjà exister ; un lien ou un dossier à cet endroit n'est jamais touché. C'est la forme la plus simple pour une page de maintenance nginx (if (-f /etc/nginx/urgence/maintenance) { return 503; }, dossier monté en lecture seule dans le conteneur) ;
  • actions : on et off sont des actions déjà déclarées, sans paramètre requis ; la commande state écrit on ou off (ou 1/0, true/false) sur sa dernière ligne.

Basculer

La page Interrupteurs du projet montre l'état de chacun, lu par l'agent. Activer… ou Désactiver… prépare l'ordre ; vous le relisez et le signez avec votre passkey. L'agent :

  1. vérifie que l'interrupteur est déclaré et se bascule dans cet environnement ;
  2. lit son état ; s'il est déjà dans l'état demandé, il ne lance rien ;
  3. crée ou retire le témoin, ou lance l'action déclarée ;
  4. relit l'état et le signe dans son résultat : l'ordre échoue si l'état relu n'est pas celui demandé.

Gel et plages horaires

Basculer un interrupteur n'est pas un geste de secours : un gel ou une plage horaire l'arrête comme un déploiement. En plein incident pendant un gel, l'accès d'urgence peut le porter. Une règle de la politique peut aussi exiger deux membres pour basculer un interrupteur.

Formule

SoloÉquipeEntreprise
Interrupteurs signésouiouioui
Cette page vous a-t-elle aidé ?Modifier cette page

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