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. 01recondistro, version et gestionnaire de paquets (apt ou dnf)
2. 02reconDocker Engine + plugin compose présents et actifs ? (sinon, étape docker)
3. 03reconDiscourse déjà installé (/var/discourse, conteneur app) ? sain → vérifier et sauter
4. 04reconports 80/443 libres ? (Discourse les prend en entier ; occupés → arrêter et signaler)
5. 05reconRAM ≥ 2 Go (+ swap) et ≥ 10 Go de disque libres
6. 06reconle domaine pointe-t-il vers ce serveur ? (requis pour Let’s Encrypt)
7. 07reconpare-feu actif (ufw ou firewalld) ? on n’ouvre un port que s’il est actif
8. 08agirInstaller Docker Engine + Compose (seulement s’il est absent)vérif
9. 09agirCloner discourse_dockervérif
10. 10agirÉcrire containers/app.ymlvérif
11. 11agirOuvrir 80/443 (seulement si un pare-feu est actif)vérif
12. 12agirConstruire et démarrer (./launcher rebuild app, 10-15 min)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érifInstaller Docker Engine + Compose (seulement s’il est absent)Vérifié parsystemctl is-active docker && docker compose versionattendu : active, puis « Docker Compose version v2… »
2. 02vérifCloner discourse_dockerVérifié partest -x /var/discourse/launcher && echo okattendu : ok
3. 03vérifÉcrire containers/app.ymlVérifié pargrep -cE '^\s*(DISCOURSE_HOSTNAME|DISCOURSE_DEVELOPER_EMAILS|DISCOURSE_SMTP_ADDRESS|DISCOURSE_SMTP_PORT|DISCOURSE_SMTP_USER_NAME|DISCOURSE_SMTP_PASSWORD|LETSENCRYPT_ACCOUNT_EMAIL):' /var/discourse/containers/app.ymlattendu : au moins 7
4. 04vérifOuvrir 80/443 (seulement si un pare-feu est actif)Vérifié parufw status 2>/dev/null | grep -cE '^(80|443)/tcp'; firewall-cmd --list-services 2>/dev/null; trueattendu : règles 80/443 présentes, ou aucun pare-feu actif (étape sautée)
5. 05vérifConstruire et démarrer (./launcher rebuild app, 10-15 min)Vérifié partimeout 270 bash -c 'while systemctl is-active -q discourse-rebuild; do sleep 15; done'; systemctl is-active discourse-rebuild; curl -s -o /dev/null -w '%{http_code}' https://${domain}/attendu : inactive puis 200 ; encore « active » = build en cours → relance ce verify (6 fois max) ; « failed » → lis le journal et arrête

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 Discourse 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 web & cms

1. 01Déployer une app Docker ComposeDéploie une stack Docker Compose (fournie), avec reverse proxy HTTPS si un domaine est donné. Décris ton besoin dans les instructions.
2. 02WordPressWordPress via Docker Compose (app + MariaDB, secrets générés), HTTPS si un domaine est fourni.
3. 03GhostPlateforme de blog Ghost 6 via Docker Compose (Ghost + MySQL), servie en HTTPS.
4. 04OdooERP Odoo 20 Community via Docker Compose (Odoo + Postgres), master password généré, HTTPS si un domaine est fourni.
5. 05MattermostMessagerie d’équipe Mattermost via Docker Compose (Mattermost + Postgres), HTTPS si un domaine est fourni.