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.
- 01reconun runner est-il déjà installé et enregistré ? (.runner présent → ne pas réenregistrer, vérifier le service)
- 02reconservices de runner existants et leur état
- 03reconl’utilisateur dédié github-runner existe-t-il ? (le runner ne tourne jamais en root)
- 04recondistro, version, architecture et gestionnaire de paquets (apt-get → Debian/Ubuntu, dnf → RHEL/Fedora/Rocky/Alma)
- 05reconDocker présent ? (si oui, ajouter github-runner au groupe docker pour les jobs conteneur)
- 06agirCréer l’utilisateur github-runnervérif
- 07agirTélécharger le runnervérif
- 08agirInstaller les dépendances du runnervérif
- 09agirEnregistrer le runnervérif
- 10agirInstaller le service systemdvé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.
- 01vérifCréer l’utilisateur github-runnerVérifié par
id github-runnerattendu : uid=… (github-runner) - 02vérifTélécharger le runnerVérifié par
test -x /opt/actions-runner/config.sh && echo okattendu : ok - 03vérifInstaller les dépendances du runnerVérifié par
ldd /opt/actions-runner/bin/Runner.Listener | grep -c "not found"attendu : 0 - 04vérifEnregistrer le runnerVérifié par
test -f /opt/actions-runner/.runner && echo okattendu : ok - 05vérifInstaller le service systemdVérifié par
systemctl is-active "$(cat /opt/actions-runner/.service)"attendu : active
SEC.03
Les garde-fous
Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.
Le registration token est un secret à usage unique : ne l’affiche jamais et ne le logge pas. Le runner tourne sous github-runner, jamais en root (pas de RUNNER_ALLOW_RUNASROOT). Ne réenregistre pas un runner existant (.runner présent) et n’utilise pas --replace sans accord. Déconseillé sur un repo public (du code non fiable s’y exécuterait).
SEC.04
Les variables
Ce que vous choisissez avant de lancer — la recette s'occupe du reste.
| Nom | Signification |
|---|---|
| ${repo_url} | URL repo/org |
| ${token} | Registration token |
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.
recherche par intention — tapez « firewall », obtenez ufw
- 01Reconnaissance en lecture seule avant tout changement
- 02Chaque commande signée par votre navigateur, validée par vous
- 03Chaque étape vérifiée avant de continuer, chaque run conservé dans l'historique
SEC.06
Bouton Deploy on Servor
Vous maintenez Runner GitHub Actions 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.
Fond sombre
Fond clair[](https://servor.app/deploy/install-gha-runner)SEC.07
D'autres recettes ci/cd
- 01GitLab RunnerGitLab Runner depuis le dépôt officiel, enregistré avec l’executor Docker ou shell.
- 02Woodpecker CICI léger Woodpecker (serveur + agent) via Docker Compose, derrière un reverse proxy HTTPS.
- 03Ansible (control node)Ansible installé comme nœud de contrôle depuis les paquets de la distro.
- 04Service systemdDaemonise une commande en service systemd géré (redémarrage auto, au boot).
- 05Tâche planifiée (cron)Ajoute une tâche planifiée via un timer systemd (journalisée, rattrapage si manquée).
Recette vérifiée
Lancez cette recette sur votre serveur
Connectez un serveur, lancez la recette, et validez chaque étape pendant que Servor exécute et vérifie. Plan gratuit, sans carte bancaire.