SEC.01

Le playbook

Le run démarre en lecture seule : les sondes de reconnaissance décident de la suite. Les étapes qui suivent sont adaptées à la distribution et à l'état trouvés — une vraie machine est rarement propre.

1. 01reconun service du même nom existe-t-il (où, actif ?) — si oui, ne pas l’écraser sans backup et accord
2. 02reconl’utilisateur existe-t-il ? (sinon le créer en compte système)
3. 03reconle binaire de la commande existe-t-il et est-il exécutable ? (ExecStart exige un chemin absolu)
4. 04agirCréer l’utilisateur ${user} (seulement s’il manque)vérif
5. 05agirÉcrire l’unitvérif
6. 06agirActiver et démarrervérif

SEC.02

Ce qu'elle vérifie

Chaque étape embarque sa propre vérification. Le run ne continue que si elle passe, donc ce que la recette annonce comme fait est ce qui est réellement sur le serveur.

1. 01vérifCréer l’utilisateur ${user} (seulement s’il manque)Vérifié parid ${user}attendu : uid=…
2. 02vérifÉcrire l’unitVérifié parsystemd-analyze verify /etc/systemd/system/${name}.service && echo okattendu : ok, sans erreur
3. 03vérifActiver et démarrerVérifié parsystemctl is-active ${name} && systemctl is-enabled ${name}attendu : active + enabled

SEC.03

Les garde-fous

Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.

SEC.04

Les variables

Ce que vous choisissez avant de lancer — la recette s'occupe du reste.

SEC.05

Comment une recette s'exécute dans Servor

Servor est zero-knowledge : la plateforme ne peut rien exécuter seule. Quand vous lancez cette recette, un run lit la reconnaissance, planifie les étapes et demande votre validation. Chaque commande approuvée est signée par votre navigateur — avec une clé que le serveur ne voit jamais — puis relayée telle quelle à l'agent, qui vérifie la signature localement avant d'exécuter.

SEC.06

Bouton Deploy on Servor

Vous maintenez Service systemd ou un projet qui en dépend ? Ajoutez ce bouton à votre README ou à votre site : en un clic, vos utilisateurs l'installent sur leur propre serveur.

SEC.07

D'autres recettes ci/cd

1. 01Runner GitHub ActionsRunner self-hosted GitHub Actions sous un utilisateur dédié, enregistré comme service systemd.
2. 02GitLab RunnerGitLab Runner depuis le dépôt officiel, enregistré avec l’executor Docker ou shell.
3. 03Woodpecker CICI léger Woodpecker (serveur + agent) via Docker Compose, derrière un reverse proxy HTTPS.
4. 04Ansible (control node)Ansible installé comme nœud de contrôle depuis les paquets de la distro.
5. 05Tâche planifiée (cron)Ajoute une tâche planifiée via un timer systemd (journalisée, rattrapage si manquée).