Files
CoHaiSe/docs/deployment.md
T
Esiah 09cf07d79b feat: migrate showcase to Next.js and overhaul CRM UI
- rebuild the public site on the Next.js App Router with static export,
  per-section SEO pages, metadata, sitemap, robots and a generated OG image
- add full-screen scroll-snap regions, staged scroll reveals, a hash-free
  tab navigation with a sliding indicator and region-by-region menu scrolling
- replace the theme text toggle with animated sun/moon icons
- restructure the CRM API into config, middleware, models, routes, services
  and utils layers
- redesign the CRM shell with a single surface, tab rail, full-width blurred
  DataTable, record dialogs and mask-based icons
- update Docker/Nginx publishing, Makefile targets, shared UI polish and docs
2026-11-16 00:52:29 +01:00

3.0 KiB

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.

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 Next.js (out/), 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

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         # Next.js local sur 3000 (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

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

make web
  1. app-build reconstruit l'image et exécute publish.sh ;
  2. la nouvelle copie est écrite dans releases/<horodatage> ;
  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

make down        # conteneurs + réseau, volume app_data conservé

Les volumes ne sont jamais supprimés par les cibles du Makefile.