dauphincraft/deploy/RUNBOOK.md

RUNBOOK — Déploiement DauphinCraft en production

Prérequis

• Accès réseau VM .86 (Gitea) et VM .89 (OpenClaw)
• Credentials : flagabat/SuperTeam2026! (ou floppyrj45)
• sshpass installé OU plink/pscp dans le PATH

Ordre d'exécution

Phase 1 — Push code Gitea (.86)

cd /c/Users/flopp/Nextcloud2/DauphinCraft
bash deploy/push_to_gitea.sh

Vérifier : http://192.168.1.86:3000/flagabat/dauphincraft/releases/tag/v0.1.0

---

Phase 2 — Déploiement serveur dédié

bash deploy/deploy_server_ssh.sh

Vérifier sur la VM cible :

systemctl status dauphincraft

Test réseau :

nc -zvu <SERVER_IP> 7777

---

Phase 3 — Landing page web

bash deploy/deploy_web_nginx.sh

Vérifier : curl http://192.168.1.86/ répond 200.

---

Phase 4 — Discord via OpenClaw

Suivre deploy/openclaw_messages.md dans l'ordre :

1. Message 1 — ping Silver Surfer
2. Message 4 — créer catégorie + channels Discord
3. Message 2 — VM si non existante
4. Message 3 — inbox deploy (après Phase 1 et 2)
5. Message 5 — webhook Gitea → #build-logs
6. Message 6 — description catégorie

---

Phase 5 — Sphinx doc (optionnel)

Upload docs/_build/html/* vers nginx :

sshpass -p SuperTeam2026! scp -r docs/_build/html/* flagabat@192.168.1.86:/var/www/dauphincraft/docs/

---

Variables d'environnement (override)

Variable	Défaut	Usage
GITEA_URL	http://192.168.1.86:3000	URL Gitea
GITEA_USER	flagabat	User Gitea
GITEA_PASS	SuperTeam2026!	Password Gitea
REPO_NAME	dauphincraft	Nom repo
SERVER_HOST	192.168.1.89	IP serveur jeu
SERVER_USER	flagabat	User SSH serveur
SERVER_PASS	SuperTeam2026!	Password SSH
WEB_HOST	192.168.1.86	IP nginx
WEB_ROOT	/var/www/dauphincraft	Racine web

Exemple override :

SERVER_HOST=192.168.1.95 bash deploy/deploy_server_ssh.sh

---

Troubleshooting

Symptôme	Solution
SSH timeout	Vérifier route IP et subnet
Gitea 401	Vérifier password ou générer jeton API dans Gitea Settings
Port 7777 fermé	ufw allow 7777/udp ou firewall-cmd --add-port=7777/udp
systemd fail	journalctl -u dauphincraft -n 50
sshpass absent	apt install sshpass ou utiliser plink (PuTTY)
Release ID vide	Vérifier git tag v0.1.0 existe sur master