- Problème de permissions de fichiers
- Partage de volume entre history-v1 et filestore
- Problème des sous-répertoires
Activer les compilations en sandbox
Les compilations en sandbox sont activées par défaut.develop/docker-compose.yml définit SANDBOXED_COMPILES=true pour clsi, et develop/dev.env contient le reste :
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (et :2025.1).
LaTeX s’exécute dans les conteneurs frères sous TEXLIVE_IMAGE_USER. Dans l’environnement de développement, il s’agit de tex, qui est aussi la valeur par défaut de clsi (services/clsi/config/settings.defaults.cjs:154). L’image de production utilise www-data à la place lorsque SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), car les fichiers y sont créés par l’utilisateur www-data du conteneur Overleaf.
Corriger les permissions de fichiers
Le conteneur clsi démarre en root, attribue les dossierscompiles, output et cache à l’utilisateur node (uid 1000), puis exécute clsi en tant que node (services/clsi/entrypoint.sh). Ainsi, develop/compiles sur l’hôte appartient à l’uid 1000, le même uid que tex dans l’environnement de développement (voir le commentaire dans develop/pandoc/Dockerfile). Avec les paramètres ci-dessus, l’environnement de développement compile sans aucune modification des permissions.
Si vous définissez plutôt TEXLIVE_IMAGE_USER=root, root (uid 0) n’a pas la permission d’écrire dans les sous-dossiers de compiles. Dans ce cas, donnez au groupe root la propriété et le droit d’écriture sur compiles, avec setgid activé pour que les nouveaux sous-dossiers héritent de cette propriété :
bash
services/clsi/README.md.
Partage de volume entre history-v1 et filestore
Les paramètres de cette section et de la suivante figurent déjà dans
develop/docker-compose.yml et develop/dev.env. Ils ne comptent qu’avec S3_ENABLED=false dans develop/dev.rc. Avec la valeur par défaut S3_ENABLED=true, filestore et history-v1 conservent plutôt ces fichiers dans des buckets RustFS (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history est aussi utilisé par le service d’historique. Ainsi, différents microservices peuvent partager les mêmes données. C’est pourquoi le service filestore de develop monte le volume history-v1-buckets de history-v1. Sans lui, clsi ne pourra pas récupérer les fichiers blob depuis le service filestore.
develop/docker-compose.yml
dev.env :
develop/dev.env
Utiliser les sous-répertoires
filestore lit toujours les blobs d’historique avec des sous-répertoires (services/filestore/app/js/KeyBuilder.js:58, :70). L’image de production active useSubdirectories pour history-v1 (server-ce/config/production.json), mais pas la configuration par défaut de history-v1, donc en développement history-v1 aplatirait toutes les données. dev.env définit donc NODE_CONFIG pour history-v1 :
develop/dev.env
project_blobs ainsi :
useSubdirectories défini à true, le _ de ces noms devient /, de sorte que chaque blob est stocké dans des sous-dossiers.
