chore: initial import of CoHaiSe Cloud
PR — Ouverture automatique / create-pr (push) Failing after 1s
PR — Ouverture automatique / create-pr (push) Failing after 1s
Standalone files & media application: React/Vite frontend with the @cohaise/ui design system, Hono + MariaDB backend, nginx reverse proxy, Docker Compose stack, migrations 000-006, and project docs. Adds Gitea Actions workflows for deployment, automatic pull requests, and Renovate dependency updates.
This commit is contained in:
@@ -0,0 +1,9 @@
|
||||
FROM nginx:1.27-alpine
|
||||
|
||||
RUN rm -f /etc/nginx/conf.d/default.conf \
|
||||
&& mkdir -p /usr/share/nginx/html
|
||||
|
||||
COPY docker/nginx/cloud.conf /etc/nginx/conf.d/app.conf
|
||||
COPY docker/nginx/snippets /etc/nginx/snippets
|
||||
|
||||
EXPOSE 80
|
||||
@@ -0,0 +1,39 @@
|
||||
# Image des services API Node du Cloud. APP_DIR choisit le paquet a construire
|
||||
# (API ou CLI de migration) ; les deux partagent la meme methode de build.
|
||||
FROM node:22-alpine AS builder
|
||||
|
||||
ARG APP_DIR
|
||||
|
||||
WORKDIR /repo
|
||||
|
||||
COPY package.json package-lock.json tsconfig.json tsconfig.base.json ./
|
||||
COPY backend ./backend
|
||||
|
||||
RUN --mount=type=cache,target=/root/.npm npm ci
|
||||
RUN npm run build --workspace=backend/shared
|
||||
RUN npm run build --workspace=${APP_DIR}
|
||||
|
||||
# On ne embarque pas les devDependencies dans l'image de production.
|
||||
RUN npm prune --omit=dev && npm cache clean --force
|
||||
|
||||
FROM node:22-alpine AS export
|
||||
|
||||
ARG APP_DIR
|
||||
|
||||
ENV NODE_ENV=production
|
||||
|
||||
WORKDIR /repo
|
||||
|
||||
COPY --from=builder /repo/package.json ./package.json
|
||||
COPY --from=builder /repo/package-lock.json ./package-lock.json
|
||||
COPY --from=builder /repo/node_modules ./node_modules
|
||||
# backend/shared est le paquet @cohaise/server : les liens de workspace
|
||||
# de node_modules pointent dessus, il doit donc voyager avec l'application.
|
||||
COPY --from=builder /repo/backend/shared ./backend/shared
|
||||
COPY --from=builder /repo/${APP_DIR} ./${APP_DIR}
|
||||
|
||||
WORKDIR /repo/${APP_DIR}
|
||||
|
||||
EXPOSE 8080
|
||||
|
||||
CMD ["node", "dist/index.js"]
|
||||
@@ -0,0 +1,18 @@
|
||||
FROM node:22-alpine AS builder
|
||||
|
||||
WORKDIR /repo
|
||||
|
||||
ARG APP_DIR
|
||||
|
||||
COPY package.json package-lock.json tsconfig.json tsconfig.base.json ./
|
||||
COPY frontend ./frontend
|
||||
|
||||
RUN --mount=type=cache,target=/root/.npm npm ci
|
||||
RUN npm run build --workspace=frontend/shared
|
||||
RUN npm run build --workspace=${APP_DIR}
|
||||
|
||||
FROM alpine:3.21 AS export
|
||||
|
||||
ARG APP_DIR
|
||||
|
||||
COPY --from=builder /repo/${APP_DIR}/dist /app/dist
|
||||
@@ -0,0 +1,102 @@
|
||||
# docker/ — images du Cloud
|
||||
|
||||
Tout ce qui touche aux images : build du front, image nginx, image API,
|
||||
configuration et publication. Ce dépôt en fabrique **quatre** (nginx, front,
|
||||
API, CLI de migration), d'où ce dossier dédié plutôt que des `Dockerfile` à la
|
||||
racine.
|
||||
|
||||
Fonctionnement du service (ordre `db → migrate → api`, ports, healthchecks) :
|
||||
[`../docs/deployment.md`](../docs/deployment.md). En-têtes et limites
|
||||
d'upload : [`../docs/security.md`](../docs/security.md).
|
||||
|
||||
## Fichiers
|
||||
|
||||
| Fichier | Rôle | Consommé par |
|
||||
| --- | --- | --- |
|
||||
| `Dockerfile` | `nginx:1.27-alpine` + `nginx/cloud.conf` | service `nginx` |
|
||||
| `Dockerfile.app` | build Vite (`node:22-alpine`), export `dist/` | service `app-build` |
|
||||
| `Dockerfile.api` | build d'un paquet backend, `npm prune --omit=dev` | services `migrate` **et** `api` |
|
||||
| `nginx/cloud.conf` | serveur : `/healthz`, proxy `/api/`, caches, SPA | copié dans l'image |
|
||||
| `nginx/snippets/` | en-têtes de sécurité, règles de cache | inclus par `cloud.conf` |
|
||||
| `publish.sh` | publication atomique dans `app_data` | monté dans `app-build` |
|
||||
|
||||
## Images
|
||||
|
||||
```sh
|
||||
docker compose build # toutes
|
||||
docker compose build api # seulement l'API
|
||||
```
|
||||
|
||||
### `Dockerfile` (nginx)
|
||||
|
||||
Supprime le `default.conf` par défaut, copie `cloud.conf` et les snippets,
|
||||
`EXPOSE 80`. Aucun module ajouté.
|
||||
|
||||
### `Dockerfile.app` (front)
|
||||
|
||||
- `ARG APP_DIR` → `frontend/cloud` (passé par compose).
|
||||
- Stage `builder` : `npm ci` (cache npm), puis
|
||||
`npm run build --workspace=frontend/shared` **avant**
|
||||
`--workspace=${APP_DIR}` — l'ordre est obligatoire, le front importe le
|
||||
design system.
|
||||
- Stage `export` : recopie `dist/` seul, sans sources ni `node_modules`.
|
||||
|
||||
### `Dockerfile.api` (back, utilisé deux fois)
|
||||
|
||||
`ARG APP_DIR` accepte deux valeurs :
|
||||
|
||||
| Service | `APP_DIR` | Résultat |
|
||||
| --- | --- | --- |
|
||||
| `migrate` | `backend/shared` | binaire `cohaise-migrate` (`dist/cli.js`) |
|
||||
| `api` | `backend/cloud` | serveur Hono (`dist/index.js`) |
|
||||
|
||||
Même image, deux cibles : le conteneur `migrate` sert, joue les migrations puis
|
||||
s'arrête ; `api` tourne en continu (`restart: unless-stopped`).
|
||||
|
||||
## Le proxy nginx
|
||||
|
||||
```nginx
|
||||
location /healthz { … }
|
||||
location /api/ { proxy_pass $cohaise_api$request_uri; client_max_body_size 5g; … }
|
||||
location /assets/ { immutable 1 an }
|
||||
location / { no-cache, fallback SPA → @spa }
|
||||
```
|
||||
|
||||
- L'upstream `api` est résolu depuis `proxy.conf` (variable `cohaise_api`) :
|
||||
l'API est appelée **en interne** sur le réseau compose, jamais via le port
|
||||
`3101` publié — ce port sert au debug.
|
||||
- `client_max_body_size 5g` doit rester **aligné** avec `users.max_file_bytes`
|
||||
(défaut 5 Go) : nginx rejette avant que l'API ne renvoie son erreur métier.
|
||||
|
||||
## Publication du front
|
||||
|
||||
Service `app-build` : `command: sh /publish.sh` avec `app_data` monté.
|
||||
|
||||
1. copie de `dist/` vers `releases/<UTC>-<pid>` ;
|
||||
2. bascule atomique du lien `current` (`ln -sfn` puis `mv -T`) ;
|
||||
3. purge des releases plus vieilles que 5 minutes.
|
||||
|
||||
Pendant la copie, nginx sert l'ancienne version : aucun reload, aucune coupure.
|
||||
|
||||
## Migrations
|
||||
|
||||
Le service `migrate` monte `./backend/cloud/migrations:/migrations:ro` (lecture
|
||||
seule) et lance :
|
||||
|
||||
```sh
|
||||
node dist/cli.js --dir /migrations # défaut, à chaque démarrage
|
||||
node dist/cli.js --dir /migrations --dry-run # simulation
|
||||
node dist/cli.js --dir /migrations --check # 1 s'il en reste
|
||||
```
|
||||
|
||||
Codes de sortie : `0` OK · `1` erreur ou dérive de checksum · `2` configuration.
|
||||
|
||||
## Modifier la configuration
|
||||
|
||||
`nginx/cloud.conf` et les snippets sont **copiés** dans l'image, pas montés :
|
||||
|
||||
```sh
|
||||
docker compose build nginx && docker compose up -d nginx
|
||||
```
|
||||
|
||||
Une simple modification sur disque ne change rien au service en cours.
|
||||
@@ -0,0 +1,62 @@
|
||||
# Limitation de debit. La zone `login` couvre les points sensibles (connexion,
|
||||
# reinitialisation) ; la zone `api` un trafic general soutenu sans etouffer les
|
||||
# envois volumineux (burst eleve, pas de mise en file).
|
||||
limit_req_zone $binary_remote_addr zone=login:10m rate=15r/m;
|
||||
limit_req_zone $binary_remote_addr zone=api:10m rate=60r/s;
|
||||
|
||||
server {
|
||||
listen 80 default_server;
|
||||
listen [::]:80 default_server;
|
||||
server_name _;
|
||||
|
||||
root /usr/share/nginx/html/current;
|
||||
index index.html;
|
||||
|
||||
include /etc/nginx/snippets/security-headers.conf;
|
||||
|
||||
gzip on;
|
||||
gzip_vary on;
|
||||
gzip_min_length 1024;
|
||||
gzip_types text/plain text/css application/javascript application/json image/svg+xml application/manifest+json;
|
||||
|
||||
location = /healthz {
|
||||
access_log off;
|
||||
default_type text/plain;
|
||||
return 200 "ok\n";
|
||||
}
|
||||
|
||||
# Points d'entree sensibles : limitation serree par IP. Une expression
|
||||
# reguliere prend le pas sur le prefixe /api/ ci-dessous.
|
||||
location ~ ^/api/cloud/(auth/login|account/forgot-password|account/reset-password|account/email-change) {
|
||||
include /etc/nginx/snippets/security-headers.conf;
|
||||
limit_req zone=login burst=5 nodelay;
|
||||
limit_req_status 429;
|
||||
include /etc/nginx/snippets/proxy-api.conf;
|
||||
}
|
||||
|
||||
# L'API. Le resolver Docker est declare dans le snippet pour que le
|
||||
# conteneur soit resolu a la demande : nginx peut demarrer avant l'API, et
|
||||
# le front reste servi pendant un redemarrage de celle-ci.
|
||||
location /api/ {
|
||||
include /etc/nginx/snippets/security-headers.conf;
|
||||
limit_req zone=api burst=120 nodelay;
|
||||
include /etc/nginx/snippets/proxy-api.conf;
|
||||
}
|
||||
|
||||
location /assets/ {
|
||||
include /etc/nginx/snippets/security-headers.conf;
|
||||
include /etc/nginx/snippets/cache-immutable.conf;
|
||||
expires 1y;
|
||||
try_files $uri =404;
|
||||
}
|
||||
|
||||
location / {
|
||||
include /etc/nginx/snippets/security-headers.conf;
|
||||
include /etc/nginx/snippets/cache-no-cache.conf;
|
||||
try_files $uri $uri/ @spa;
|
||||
}
|
||||
|
||||
location @spa {
|
||||
try_files /index.html =404;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1 @@
|
||||
add_header Cache-Control "public, immutable" always;
|
||||
@@ -0,0 +1 @@
|
||||
add_header Cache-Control "no-cache" always;
|
||||
@@ -0,0 +1,14 @@
|
||||
# Relay vers l'API. Resolver Docker declare pour resoudre le conteneur a la
|
||||
# demande : nginx peut demarrer avant l'API et lui survit pendant un
|
||||
# redemarrage.
|
||||
resolver 127.0.0.11 valid=30s ipv6=off;
|
||||
set $cohaise_api http://api:8080;
|
||||
proxy_pass $cohaise_api$request_uri;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
proxy_read_timeout 60s;
|
||||
# Aligne sur la borne de depot du Cloud.
|
||||
client_max_body_size 5g;
|
||||
@@ -0,0 +1,8 @@
|
||||
# En-tetes de securite communs. CSP stricte : aucun script en ligne, aucun
|
||||
# cadre, aucune origine externe. Les styles tolerent l'inline (attributs
|
||||
# `style=` de React) : c'est une concession sans effet sur l'execution de code.
|
||||
add_header Content-Security-Policy "default-src 'self'; base-uri 'none'; object-src 'none'; frame-ancestors 'none'; form-action 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; media-src 'self' blob:; font-src 'self' data:; connect-src 'self'" always;
|
||||
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
|
||||
add_header X-Content-Type-Options "nosniff" always;
|
||||
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
|
||||
add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
|
||||
@@ -0,0 +1,17 @@
|
||||
#!/bin/sh
|
||||
set -eu
|
||||
|
||||
SRC="${1:-/app/dist}"
|
||||
DEST="${2:-/output}"
|
||||
|
||||
REL="releases/$(date -u +%Y%m%dT%H%M%SZ)-$$"
|
||||
KEEP=$(basename "$REL")
|
||||
|
||||
mkdir -p "$DEST/$REL"
|
||||
cp -a "$SRC/." "$DEST/$REL/"
|
||||
touch "$DEST/$REL"
|
||||
|
||||
ln -sfn "$REL" "$DEST/.current.tmp"
|
||||
mv -T "$DEST/.current.tmp" "$DEST/current"
|
||||
|
||||
find "$DEST/releases" -mindepth 1 -maxdepth 1 -type d ! -name "$KEEP" -mmin +5 -exec rm -rf {} + 2>/dev/null || true
|
||||
Reference in New Issue
Block a user