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.
- 01reconle compte existe-t-il ? son dossier personnel (souvent /Users/<compte>)
- 02reconun runner est-il déjà configuré / installé en service ?
- 03reconarchitecture (arm64 → osx-arm64, x86_64 → osx-x64) et dernière version du runner
- 04reconsession ouverte pour ce compte (requis par svc.sh) ? CLT présents ?
- 05agirTélécharger le runnervérif
- 06agirExtrairevérif
- 07agirEnregistrervérif
- 08agirInstaller le servicevé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érifTélécharger le runnerVérifié par
tar tzf /Users/${user}/actions-runner/runner.tar.gz | grep -c config.shattendu : au moins 1 - 02vérifExtraireVérifié par
test -x /Users/${user}/actions-runner/config.sh && echo okattendu : ok - 03vérifEnregistrerVérifié par
test -f /Users/${user}/actions-runner/.runner && echo okattendu : ok - 04vérifInstaller le serviceVérifié par
sudo -u ${user} -H bash -c 'cd /Users/${user}/actions-runner && ./svc.sh status' 2>&1 | grep -ci startedattendu : au moins 1
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 (1 h) : ne le réaffiche pas. Le runner ne tourne jamais en root. svc.sh crée un LaunchAgent : il ne démarre que si ce compte a une session ouverte (connexion automatique), sinon signale-le et propose create-launchd-service avec run_as.
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 |
| ${user} | Compte du runner (non root) |
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 (macOS) 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-github-runner-macos)SEC.07
D'autres recettes ci/cd
- 01Runner GitHub ActionsRunner self-hosted GitHub Actions sous un utilisateur dédié, enregistré comme service systemd.
- 02GitLab RunnerGitLab Runner depuis le dépôt officiel, enregistré avec l’executor Docker ou shell.
- 03Woodpecker CICI léger Woodpecker (serveur + agent) via Docker Compose, derrière un reverse proxy HTTPS.
- 04Ansible (control node)Ansible installé comme nœud de contrôle depuis les paquets de la distro.
- 05Service systemdDaemonise une commande en service systemd géré (redémarrage auto, au boot).
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.