- Problem z uprawnieniami do plików
- Współdzielenie wolumenu między history-v1 a filestore
- Problem z podkatalogami
Włączanie Sandbox Compiles
Kompilacje w piaskownicy są domyślnie włączone.develop/docker-compose.yml ustawia SANDBOXED_COMPILES=true dla clsi, a develop/dev.env zawiera resztę:
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (oraz :2025.1).
LaTeX działa w kontenerach siostrzanych jako TEXLIVE_IMAGE_USER. W środowisku deweloperskim jest to tex, który jest też domyślną wartością clsi (services/clsi/config/settings.defaults.cjs:154). Obraz produkcyjny używa zamiast tego www-data, gdy SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), ponieważ tam pliki tworzy użytkownik www-data kontenera Overleaf.
Naprawa uprawnień do plików
Kontener clsi uruchamia się jako root, przekazuje folderycompiles, output i cache użytkownikowi node (uid 1000), a następnie uruchamia clsi jako node (services/clsi/entrypoint.sh). Dlatego develop/compiles na hoście należy do uid 1000, tego samego uid co tex w środowisku deweloperskim (zobacz komentarz w develop/pandoc/Dockerfile). Przy powyższych ustawieniach środowisko deweloperskie kompiluje bez żadnej zmiany uprawnień.
Jeśli zamiast tego ustawisz TEXLIVE_IMAGE_USER=root, root (uid 0) nie ma uprawnień do zapisu w podfolderach compiles. W takim przypadku nadaj grupie root własność i prawo zapisu do compiles, z ustawionym setgid, aby nowe podfoldery dziedziczyły tę własność:
bash
services/clsi/README.md.
Współdzielenie wolumenu między history-v1 a filestore
Ustawienia z tej i następnej sekcji są już w
develop/docker-compose.yml i develop/dev.env. Mają znaczenie tylko przy S3_ENABLED=false w develop/dev.rc. Przy domyślnym S3_ENABLED=true filestore i history-v1 przechowują te pliki w bucketach RustFS (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history jest też używany przez usługę historii. Dzięki temu różne mikrousługi mogą współdzielić te same dane. Dlatego usługa filestore w develop montuje wolumin history-v1-buckets z history-v1. Bez niego clsi nie będzie mógł pobierać plików blob z usługi filestore.
develop/docker-compose.yml
dev.env:
develop/dev.env
Używanie podkatalogów
filestore zawsze odczytuje bloby historii z podkatalogami (services/filestore/app/js/KeyBuilder.js:58, :70). Obraz produkcyjny włącza useSubdirectories dla history-v1 (server-ce/config/production.json), ale domyślna konfiguracja history-v1 tego nie robi, więc w środowisku deweloperskim history-v1 spłaszczyłby wszystkie dane. Dlatego dev.env ustawia NODE_CONFIG dla history-v1:
develop/dev.env
project_blobs w ten sposób:
useSubdirectories ma wartość true, znak _ w tych nazwach zmienia się w /, więc każdy blob jest zapisywany w podfolderach.
