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.
- 01reconDocker Engine + plugin compose installés et service actif ?
- 02recondéjà déployé ? conteneurs, volumes et /opt/woodpecker existants (→ ne pas régénérer les secrets)
- 03reconports 8000 (Woodpecker local), 80/443 (reverse proxy) libres ou déjà tenus par quoi ?
- 04reconreverse proxy déjà en place (Caddy/nginx) à réutiliser ?
- 05recondistro, version, architecture et gestionnaire de paquets (apt-get → Debian/Ubuntu, dnf → RHEL/Fedora/Rocky/Alma)
- 06reconpare-feu actif (ufw/firewalld) → ouvrir 80/443 seulement
- 07reconau moins 1 Go de RAM et quelques Go libres
- 08agirInstaller Docker Engine (si absent)vérif
- 09agirGénérer les secretsvérif
- 10agirÉcrire /opt/woodpecker/compose.yamlvérif
- 11agirDémarrer Woodpeckervérif
- 12agirReverse proxy HTTPS pour ${domain}vé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érifInstaller Docker Engine (si absent)Vérifié par
systemctl is-active docker && docker compose versionattendu : active + une version de Docker Compose - 02vérifGénérer les secretsVérifié par
stat -c "%a %n" /opt/woodpecker/server.env /opt/woodpecker/agent.envattendu : 600 pour les deux fichiers - 03vérifÉcrire /opt/woodpecker/compose.yamlVérifié par
docker compose -f /opt/woodpecker/compose.yaml config -q && echo okattendu : ok - 04vérifDémarrer WoodpeckerVérifié par
curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:8000/healthzattendu : 200 - 05vérifReverse proxy HTTPS pour ${domain}Vérifié par
curl -s -o /dev/null -w '%{http_code}' https://${domain}/healthzattendu : 200
SEC.03
Les garde-fous
Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.
Les secrets OAuth et l’agent secret ne s’affichent jamais (pas de cat des fichiers .env) et ne se régénèrent pas s’ils existent. Le port 8000 reste sur 127.0.0.1, seul le proxy HTTPS est public. Inscriptions fermées (WOODPECKER_OPEN=false) : l’agent a accès au socket Docker, donc tout utilisateur peut exécuter du code en root. Callback OAuth à déclarer dans la forge : https://<domaine>/authorize.
SEC.04
Les variables
Ce que vous choisissez avant de lancer — la recette s'occupe du reste.
| Nom | Signification |
|---|---|
| ${domain} | Domaine |
| ${forge} | Forge |
| ${forge_url} | URL de la forge (Gitea/Forgejo/GitLab) |
| ${oauth_client} | OAuth client ID |
| ${oauth_secret} | OAuth client secret |
| ${admin} | Compte admin (identifiant forge) |
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 Woodpecker CI 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-woodpecker)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.
- 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.