Ajout d'un compose.yaml

- Service unique : build local (ou image publiée en commentaire), non-root,
  restart: unless-stopped.
- config.json monté en lecture seule ; un montage ./data:/data pour les
  dossiers de dépôt (les `dir` des targets pointent sous /data).
- Commentaires sur l'uid 1000, le remap de port, l'override `user:`.
- .gitignore / .dockerignore : ajout de data/ ; README : section Docker
  réécrite autour de Compose.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Nicolas 2026-09-09 23:25:11 +02:00
parent f32a04c56f
commit f9f17bd169
4 changed files with 59 additions and 22 deletions

View file

@ -7,6 +7,7 @@ coverage
.env
config.json
uploads
data
# VCS / outillage / docs sans intérêt au build
.git
@ -25,5 +26,6 @@ eslint.config.mjs
.prettierignore
Dockerfile
.dockerignore
compose.yaml
README.md
Claude.md

1
.gitignore vendored
View file

@ -4,4 +4,5 @@ coverage/
.env
config.json
uploads/
data/
*.log

View file

@ -62,37 +62,37 @@ 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.
`sodium-native`), exécutée en non-root. Le `config.json` et les dossiers de
dépôt sont **montés**, jamais inclus dans l'image.
### Compose (recommandé)
Voir [`compose.yaml`](compose.yaml).
```bash
cp config.example.json config.json # puis éditer publicUrl, session.key, oidc.*
mkdir -p ./data && sudo chown -R 1000:1000 ./data
docker compose up -d --build
```
Dans `config.json`, faire pointer les `dir` des `targets` sous `/data`
(ex. `"dir": "/data/photos"`). Le conteneur tourne en uid `1000` (utilisateur
`node`) : `./data` doit lui être inscriptible.
### Sans Compose
```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" \
-v "$PWD/data:/data" \
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.
conteneur s'arrête (d'où `restart: unless-stopped`). Le `HEALTHCHECK` interroge
`GET /health` sur le port `3000` — garder `port: 3000` dans `config.json` et
remapper côté hôte si besoin.
## Endpoints
@ -187,6 +187,7 @@ Seule variable d'environnement : `MEDIADROP_CONFIG` (chemin du fichier, défaut
config.example.json modèle de configuration (à copier en config.json)
config.schema.json schéma JSON (validation / autocomplétion éditeur)
Dockerfile image multi-stage (deps / build / runtime non-root)
compose.yaml déploiement Docker Compose (config + /data montés)
src/
index.ts entrée : config -> app -> écoute + arrêt propre
app.ts construction de l'instance Fastify (exportée pour les tests)

33
compose.yaml Normal file
View file

@ -0,0 +1,33 @@
# Démarrage :
# cp config.example.json config.json # puis éditer (publicUrl, session.key, oidc.*)
# mkdir -p ./data && sudo chown -R 1000:1000 ./data
# docker compose up -d --build
#
# Dans config.json, faire pointer les `dir` des `targets` sous /data,
# par ex. { "name": "photos", "dir": "/data/photos" }.
services:
mediadrop:
build:
context: .
dockerfile: Dockerfile
# Alternative : utiliser une image publiée plutôt que builder localement.
# image: git.dev.kyuno.fr/kyuno/mediadrop:latest
container_name: mediadrop
restart: unless-stopped
ports:
# <hôte>:<conteneur>. Garder 3000 côté conteneur (= `port` de config.json
# et port du HEALTHCHECK) ; remapper côté hôte si besoin, ex. "8080:3000".
- '3000:3000'
volumes:
# Configuration, en lecture seule — montée, jamais incluse dans l'image.
- ./config.json:/app/config.json:ro
# Données : les `dir` des `targets` doivent vivre sous /data.
- ./data:/data
# Le conteneur tourne en uid 1000 (utilisateur `node`) : ./data doit lui être
# inscriptible (voir le chown ci-dessus). Sous Linux, pour tourner sous ton
# propre uid avec des dossiers t'appartenant :
# user: '${MEDIADROP_UID:-1000}:${MEDIADROP_GID:-1000}'