Files
CoHaiSe/docs/deployment.md
T
Esiah 858d862fed
deploy / deploy (push) Canceled after 0s
feat: init repo
2026-11-10 19:56:03 +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 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

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

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.