Ajout d'un Dockerfile multi-stage + .dockerignore
- Build en 3 étapes (deps prod / compilation TS / runtime), image node:22-bookworm-slim exécutée en non-root (utilisateur `node`). - Debian slim et non Alpine : @fastify/secure-session dépend de sodium-native, dont les prebuilds linux-x64/arm64 ciblent la glibc. - config.json et dossiers de dépôt montés en volumes, jamais dans l'image (.dockerignore exclut .env, config.json, uploads, node_modules, dist...). - HEALTHCHECK sur GET /health ; section Docker ajoutée au README. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
parent
fe8bd26bb7
commit
f32a04c56f
3 changed files with 110 additions and 0 deletions
29
.dockerignore
Normal file
29
.dockerignore
Normal file
|
|
@ -0,0 +1,29 @@
|
||||||
|
# Build artefacts / dépendances (réinstallées / recompilées dans l'image)
|
||||||
|
node_modules
|
||||||
|
dist
|
||||||
|
coverage
|
||||||
|
|
||||||
|
# Secrets & données locales — ne JAMAIS envoyer dans le contexte de build
|
||||||
|
.env
|
||||||
|
config.json
|
||||||
|
uploads
|
||||||
|
|
||||||
|
# VCS / outillage / docs sans intérêt au build
|
||||||
|
.git
|
||||||
|
.gitattributes
|
||||||
|
.gitignore
|
||||||
|
.github
|
||||||
|
.vscode
|
||||||
|
.idea
|
||||||
|
*.log
|
||||||
|
|
||||||
|
# Non nécessaires à la compilation de l'app
|
||||||
|
tests
|
||||||
|
vitest.config.ts
|
||||||
|
eslint.config.mjs
|
||||||
|
.prettierrc.json
|
||||||
|
.prettierignore
|
||||||
|
Dockerfile
|
||||||
|
.dockerignore
|
||||||
|
README.md
|
||||||
|
Claude.md
|
||||||
45
Dockerfile
Normal file
45
Dockerfile
Normal file
|
|
@ -0,0 +1,45 @@
|
||||||
|
# syntax=docker/dockerfile:1
|
||||||
|
|
||||||
|
# Image Debian slim (glibc) : @fastify/secure-session -> sodium-native embarque
|
||||||
|
# des prebuilds linux-x64 / linux-arm64 compilés pour la glibc (pas de variante
|
||||||
|
# musl), donc Alpine ne conviendrait pas.
|
||||||
|
|
||||||
|
# ---- deps : node_modules de production uniquement ----------------------------
|
||||||
|
FROM node:22-bookworm-slim AS deps
|
||||||
|
WORKDIR /app
|
||||||
|
COPY package.json package-lock.json ./
|
||||||
|
RUN npm ci --omit=dev --no-audit --no-fund
|
||||||
|
|
||||||
|
# ---- build : compilation TypeScript ----------------------------------------------
|
||||||
|
FROM node:22-bookworm-slim AS build
|
||||||
|
WORKDIR /app
|
||||||
|
COPY package.json package-lock.json ./
|
||||||
|
RUN npm ci --no-audit --no-fund
|
||||||
|
COPY tsconfig.json tsconfig.build.json ./
|
||||||
|
COPY src ./src
|
||||||
|
RUN npm run build
|
||||||
|
|
||||||
|
# ---- runtime ----------------------------------------------------------------------
|
||||||
|
FROM node:22-bookworm-slim AS runtime
|
||||||
|
ENV NODE_ENV=production \
|
||||||
|
MEDIADROP_CONFIG=/app/config.json
|
||||||
|
WORKDIR /app
|
||||||
|
|
||||||
|
COPY --from=deps /app/node_modules ./node_modules
|
||||||
|
COPY --from=build /app/dist ./dist
|
||||||
|
COPY public ./public
|
||||||
|
COPY package.json ./
|
||||||
|
|
||||||
|
# Dossier de dépôt par défaut, inscriptible par l'utilisateur non-root `node`.
|
||||||
|
# (Pour des cibles hors de /app, monter des volumes appartenant à l'uid 1000.)
|
||||||
|
RUN mkdir -p /app/uploads && chown -R node:node /app/uploads
|
||||||
|
|
||||||
|
USER node
|
||||||
|
EXPOSE 3000
|
||||||
|
|
||||||
|
# GET /health ne demande aucune authentification.
|
||||||
|
# Adapter le port si `port` diffère de 3000 dans config.json.
|
||||||
|
HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --retries=3 \
|
||||||
|
CMD ["node", "-e", "fetch('http://127.0.0.1:3000/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
|
||||||
|
|
||||||
|
CMD ["node", "dist/index.js"]
|
||||||
36
README.md
36
README.md
|
|
@ -59,6 +59,41 @@ npm run build
|
||||||
npm start
|
npm start
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Docker
|
||||||
|
|
||||||
|
Image multi-stage (Debian slim ; Alpine exclu à cause du module natif
|
||||||
|
`sodium-native`). Le `config.json` et les dossiers de dépôt sont montés, jamais
|
||||||
|
inclus dans l'image.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker build -t mediadrop .
|
||||||
|
|
||||||
|
docker run --rm -p 3000:3000 \
|
||||||
|
-v "$PWD/config.json:/app/config.json:ro" \
|
||||||
|
-v "$PWD/data/photos:/data/photos" \
|
||||||
|
mediadrop
|
||||||
|
```
|
||||||
|
|
||||||
|
Les `dir` des `targets` doivent pointer vers des chemins montés, inscriptibles
|
||||||
|
par l'uid `1000` (utilisateur `node`). Exemple `compose.yaml` :
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
services:
|
||||||
|
mediadrop:
|
||||||
|
build: .
|
||||||
|
ports:
|
||||||
|
- '3000:3000'
|
||||||
|
volumes:
|
||||||
|
- ./config.json:/app/config.json:ro
|
||||||
|
- ./data/photos:/data/photos
|
||||||
|
- ./data/videos:/data/videos
|
||||||
|
restart: unless-stopped
|
||||||
|
```
|
||||||
|
|
||||||
|
La découverte OIDC a lieu au démarrage : si l'issuer est injoignable, le
|
||||||
|
conteneur s'arrête (utiliser `restart: unless-stopped`). Le `HEALTHCHECK`
|
||||||
|
interroge `GET /health` sur le port `3000` — l'adapter si `port` diffère.
|
||||||
|
|
||||||
## Endpoints
|
## Endpoints
|
||||||
|
|
||||||
| Route | Auth | Rôle |
|
| Route | Auth | Rôle |
|
||||||
|
|
@ -151,6 +186,7 @@ Seule variable d'environnement : `MEDIADROP_CONFIG` (chemin du fichier, défaut
|
||||||
```
|
```
|
||||||
config.example.json modèle de configuration (à copier en config.json)
|
config.example.json modèle de configuration (à copier en config.json)
|
||||||
config.schema.json schéma JSON (validation / autocomplétion éditeur)
|
config.schema.json schéma JSON (validation / autocomplétion éditeur)
|
||||||
|
Dockerfile image multi-stage (deps / build / runtime non-root)
|
||||||
src/
|
src/
|
||||||
index.ts entrée : config -> app -> écoute + arrêt propre
|
index.ts entrée : config -> app -> écoute + arrêt propre
|
||||||
app.ts construction de l'instance Fastify (exportée pour les tests)
|
app.ts construction de l'instance Fastify (exportée pour les tests)
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue