# Déploiement — CoHaiSe Web ## Prérequis Docker avec le plugin Compose, `make`. Rien d'autre : la vitrine n'a besoin d'aucun secret, d'aucune base, d'aucun compte. ```sh cp .env.example .env # optionnel make up # build + démarrage sur 8080 ``` ## Compose `docker-compose.yml` — projet **`cohaise-web`**, deux services, un volume : | Service | Image | Port | Rôle | | --- | --- | --- | --- | | `app-build` | `docker/Dockerfile.app` | — | build Vite, `restart: "no"` | | `nginx` | `docker/Dockerfile` | `${COHAISE_HTTP_PORT:-8080}:80` | rendu, `restart: unless-stopped` | Volume unique : `app_data` (`/usr/share/nginx/html`), monté par les deux. Aucun `depends_on` : le lien est le partage du volume. `app-build` publie puis s'arrête ; nginx n'a jamais à redémarrer. Healthcheck nginx : `wget -qO- http://127.0.0.1/healthz`, 10 s d'intervalle, 3 s de timeout, 3 essais. ## Variables Seule variable consommée : `COHAISE_HTTP_PORT` (défaut `8080`), lue par la substitution Compose — il n'y a pas de `env_file`. Le `.env.example` contient encore les clés des anciennes apps (CRM, Cloud, `SESSION_SECRET`…) : **inutiles ici**, la stack n'en lit aucune. Ne pas les supprimer sans vérifier qu'aucune autre cible ne les référence. ## Commandes ```sh make help # liste complète make up # build + démarrage make web # reconstruire et republier la vitrine (sans interruption) make reload # nginx -s reload, sans coupure make build # construire les images sans redémarrer make ps # état make logs # journaux suivis make dev # Vite local sur 5173 (hors Docker) make down # arrêt, volumes conservés ``` `make help` affiche aussi `npm run typecheck` / `npm run build` sous « Vérification » : aucune cible Makefile ne les exécute, ce sont des commandes npm à taper directement. ## Vérification ```sh curl -I http://localhost:8080/healthz # HTTP/1.1 200 ok curl -s http://localhost:8080/ | head # index.html servi par le symlink current ``` ## Publication d'une version ```sh make web ``` 1. `app-build` reconstruit l'image et exécute `publish.sh` ; 2. la nouvelle copie est écrite dans `releases/` ; 3. le lien `current` bascule par `mv -T` (atomique) ; 4. nginx sert immédiatement la nouvelle version, sans reload. En cas de régression, l'ancienne release existe encore quelques minutes : on peut re-basculer le lien manuellement dans le conteneur avant la purge automatique. ## Exposition publique Le port est publié **sans bind IP** (`0.0.0.0:8080`). L'exposition sur Internet passe par le tunnel cloudflared, qui vit dans un conteneur **hors de ce dépôt** : ne rien y changer depuis ici. Le `.dev` est HSTS-preload, donc `/etc/hosts` ne sert jamais à tester `cohaise.dev` en local — utiliser `localhost:8080`. ## Arrêt ```sh make down # conteneurs + réseau, volume app_data conservé ``` Les volumes ne sont jamais supprimés par les cibles du Makefile.