@@ -0,0 +1,90 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user