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. 01reconDocker Engine + plugin compose présents ?
2. 02reconGarage déjà installé (conteneur, binaire, service) ou /opt/garage/garage.toml existant ? → ne pas recréer ni régénérer les secrets, vérifier
3. 03reconports 3900-3903 libres ? (vide, sauf un Garage déjà en place)
4. 04reconespace libre > capacité ${capacity} demandée (sinon la réduire) et RAM ≥ 512 Mo
5. 05recondistro pour le dépôt Docker officiel
6. 06reconseulement si un domaine est fourni : un reverse proxy occupe-t-il déjà 80/443 ? (le réutiliser)
7. 07agirDépôt Docker officiel (seulement si Docker absent)vérif
8. 08agirDéclarer la source apt Docker (Debian/Ubuntu, si Docker absent)vérif
9. 09agirInstaller Docker Engine (si absent)vérif
10. 10agirÉcrire /opt/garage/garage.toml (secrets générés)vérif
11. 11agirÉcrire /opt/garage/compose.yamlvérif
12. 12agirLancer Garagevérif
13. 13agirAssigner le layout mono-nœud (${capacity})vérif
14. 14agirAppliquer le layoutvérif
15. 15agirCréer le bucket ${bucket}vérif
16. 16agirCréer la clé d’accès ${key_name}vérif
17. 17agirDonner à la clé l’accès au bucketvérif
18. 18agirHealth check de l’API S3vérif
19. 19agirInstaller Caddy (seulement si un domaine est fourni et aucun reverse proxy)vérif
20. 20agirReverse proxy HTTPS de l’API S3 (seulement si un domaine est fourni)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.

1. 01vérifDépôt Docker officiel (seulement si Docker absent)Vérifié partest -s /etc/apt/keyrings/docker.asc -o -f /etc/yum.repos.d/docker-ce.repo && echo okattendu : ok
2. 02vérifDéclarer la source apt Docker (Debian/Ubuntu, si Docker absent)Vérifié parcat /etc/apt/sources.list.d/docker.listattendu : une ligne deb … signed-by=/etc/apt/keyrings/docker.asc
3. 03vérifInstaller Docker Engine (si absent)Vérifié parsystemctl is-active docker && docker compose versionattendu : active puis Docker Compose version v2.x
4. 04vérifÉcrire /opt/garage/garage.toml (secrets générés)Vérifié parstat -c '%a %U' /opt/garage/garage.toml && grep -cE '^(rpc_secret|admin_token|metrics_token) = "[^"]+"' /opt/garage/garage.tomlattendu : 600 root puis 3
5. 05vérifÉcrire /opt/garage/compose.yamlVérifié pardocker compose -f /opt/garage/compose.yaml config -q && echo okattendu : ok
6. 06vérifLancer GarageVérifié pardocker ps --filter name=^garage$ --format "{{.Status}}" && docker exec garage /garage statusattendu : Up … puis un nœud listé (NO ROLE ASSIGNED avant le layout)
7. 07vérifAssigner le layout mono-nœud (${capacity})Vérifié pardocker exec garage /garage layout showattendu : un rôle dc1 avec la capacité demandée (staged ou appliqué)
8. 08vérifAppliquer le layoutVérifié parcurl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:3903/healthattendu : 200
9. 09vérifCréer le bucket ${bucket}Vérifié pardocker exec garage /garage bucket listattendu : ${bucket} dans la liste
10. 10vérifCréer la clé d’accès ${key_name}Vérifié parstat -c '%a' /root/servor-garage-${key_name}.key && grep -ci 'secret' /root/servor-garage-${key_name}.keyattendu : 600 puis au moins 1
11. 11vérifDonner à la clé l’accès au bucketVérifié pardocker exec garage /garage bucket info ${bucket}attendu : la clé ${key_name} listée avec les droits RWO
12. 12vérifHealth check de l’API S3Vérifié parcurl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:3900/attendu : 403 (API S3 qui répond, requête anonyme refusée)
13. 13vérifInstaller Caddy (seulement si un domaine est fourni et aucun reverse proxy)Vérifié parcaddy version && systemctl is-active caddyattendu : v2.… puis active
14. 14vérifReverse proxy HTTPS de l’API S3 (seulement si un domaine est fourni)Vérifié parcurl -s -o /dev/null -w '%{http_code}' --retry 6 --retry-delay 5 https://${domain}/attendu : 403 (certificat obtenu, API S3 joignable)

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 Garage (stockage S3) 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 stockage & backup

1. 01Fichier d’échange (swap)Crée un fichier de swap de la taille choisie, persistant. Destructif : modifie /etc/fstab.
2. 02Sauvegardes resticrestic + sauvegarde planifiée et chiffrée d’un dossier vers un dépôt.
3. 03MinIOStockage objet S3-compatible MinIO via Docker, en local. Projet communautaire archivé : image figée.
4. 04Partage SambaServeur de fichiers Samba (SMB). Destructif : crée un partage et un utilisateur.
5. 05Sauvegardes BorgBorgBackup + une sauvegarde planifiée chiffrée d’un dossier.