- Problema dei permessi dei file
- Condivisione del volume tra history-v1 e filestore
- Problema delle sottodirectory
Abilitare le Sandbox Compiles
Le compilazioni in sandbox sono attive per impostazione predefinita.develop/docker-compose.yml imposta SANDBOXED_COMPILES=true per clsi, e develop/dev.env contiene il resto:
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (e :2025.1).
LaTeX viene eseguito nei container fratelli come TEXLIVE_IMAGE_USER. Nell’ambiente di sviluppo è tex, che è anche il valore predefinito di clsi (services/clsi/config/settings.defaults.cjs:154). L’immagine di produzione usa invece www-data quando SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), perché lì i file vengono creati dall’utente www-data del container di Overleaf.
Correggere i permessi dei file
Il container di clsi si avvia come root, assegna le cartellecompiles, output e cache all’utente node (uid 1000) e poi esegue clsi come node (services/clsi/entrypoint.sh). Quindi develop/compiles sull’host appartiene all’uid 1000, lo stesso uid di tex nell’ambiente di sviluppo (vedi il commento in develop/pandoc/Dockerfile). Con le impostazioni sopra, l’ambiente di sviluppo compila senza alcuna modifica dei permessi.
Se invece imposti TEXLIVE_IMAGE_USER=root, root (uid 0) non ha il permesso di scrivere nelle sottocartelle di compiles. In tal caso, assegna al gruppo root la proprietà e il permesso di scrittura su compiles, con setgid impostato in modo che le nuove sottocartelle ereditino questa proprietà:
bash
services/clsi/README.md.
Condivisione del volume tra history-v1 e filestore
Le impostazioni di questa sezione e della successiva sono già in
develop/docker-compose.yml e develop/dev.env. Contano solo con S3_ENABLED=false in develop/dev.rc. Con il valore predefinito S3_ENABLED=true, filestore e history-v1 conservano invece questi file in bucket RustFS (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history è usato anche dal servizio della cronologia. In questo modo microservizi diversi possono condividere gli stessi dati. Per questo il servizio filestore in develop monta il volume history-v1-buckets di history-v1. Senza di esso, clsi non potrà recuperare i file blob dal servizio filestore.
develop/docker-compose.yml
dev.env:
develop/dev.env
Usare le sottodirectory
filestore legge sempre i blob della cronologia con sottodirectory (services/filestore/app/js/KeyBuilder.js:58, :70). L’immagine di produzione attiva useSubdirectories per history-v1 (server-ce/config/production.json), ma la configurazione predefinita di history-v1 no, quindi in sviluppo history-v1 appiattirebbe tutti i dati. Per questo dev.env imposta NODE_CONFIG per history-v1:
develop/dev.env
project_blobs così:
useSubdirectories impostato a true, il _ in questi nomi diventa /, così ogni blob viene salvato in sottocartelle.
