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

91 lines
3.0 KiB
Markdown

# 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/<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
```sh
make down # conteneurs + réseau, volume app_data conservé
```
Les volumes ne sont jamais supprimés par les cibles du Makefile.