deploy / deploy (push) Successful in 1m24s
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 Co-authored-by: Gitea Actions <-[email protected]>
91 lines
3.0 KiB
Markdown
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 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
|
|
|
|
```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 # 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
|
|
|
|
```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.
|