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 présent et actif (prérequis)
- 02reconregistre déjà déployé ? volume registry_data existant (à réutiliser) ?
- 03reconport 5000 libre ?
- 04reconidentifiants déjà générés ?
- 05reconreverse proxy présent (Caddy ou Nginx) pour le TLS si un domaine est fourni
- 06agirGénérer le mot de passevérif
- 07agirCréer le fichier htpasswd (bcrypt)vérif
- 08agirLancer le registrevérif
- 09agirReverse proxy TLS (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.
- 01vérifGénérer le mot de passeVérifié par
stat -c %a /opt/registry/admin_passwordattendu : 600 - 02vérifCréer le fichier htpasswd (bcrypt)Vérifié par
grep -c '^${username}:\$2y\$' /opt/registry/auth/htpasswdattendu : 1 - 03vérifLancer le registreVérifié par
curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:5000/v2/; echo; curl -s -o /dev/null -w '%{http_code}' -u ${username}:$(cat /opt/registry/admin_password) http://127.0.0.1:5000/v2/attendu : 401 sans identifiants, puis 200 avec - 04vérifReverse proxy TLS (seulement si un domaine est fourni)Vérifié par
curl -s -o /dev/null -w '%{http_code}' -u ${username}:$(cat /opt/registry/admin_password) https://${domain}/v2/attendu : 200
SEC.03
Les garde-fous
Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.
Si Docker ou le plugin compose manque : arrête-toi et indique de lancer d’abord la recette « Docker Engine » (ne l’installe pas à la volée). Jamais de registre exposé sans TLS + auth : il écoute sur 127.0.0.1:5000, l’accès distant passe par le reverse proxy TLS. Ne supprime jamais le volume registry_data. Indique où lire le mot de passe : /opt/registry/admin_password. Ne logge pas le mot de passe.
SEC.04
Les variables
Ce que vous choisissez avant de lancer — la recette s'occupe du reste.
| Nom | Signification |
|---|---|
| ${username} | Utilisateur du registre |
| ${domain} | Domaine (optionnel, pour TLS) |
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 Registre Docker privé 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 conteneurs
- 01Docker EngineDocker Engine + Compose depuis le dépôt officiel, service actif, hello-world vérifié.
- 02Docker ComposePlugin Docker Compose (docker compose), installé et vérifié.
- 03PodmanPodman (conteneurs sans daemon, rootless possible), vérifié.
- 04PortainerInterface web de gestion Docker Portainer CE (LTS), admin pré-configuré.
- 05k3s (Kubernetes léger)Cluster mono-nœud k3s. Destructif : configure le réseau et un runtime conteneurs.
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.