- Probleem met bestandsrechten
- Gedeeld volume tussen history-v1 en filestore
- Probleem met submappen
Sandbox-compilaties inschakelen
Sandbox-compilaties staan standaard aan.develop/docker-compose.yml zet SANDBOXED_COMPILES=true voor clsi, en develop/dev.env bevat de rest:
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (en :2025.1).
LaTeX draait in de zustercontainers als TEXLIVE_IMAGE_USER. In de ontwikkelomgeving is dat tex, wat ook de standaard van clsi is (services/clsi/config/settings.defaults.cjs:154). De productie-image gebruikt in plaats daarvan www-data wanneer SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), omdat de bestanden daar worden aangemaakt door de gebruiker www-data van de Overleaf-container.
Bestandsrechten herstellen
De clsi-container start als root, geeft de mappencompiles, output en cache aan de gebruiker node (uid 1000) en voert clsi daarna uit als node (services/clsi/entrypoint.sh). Daardoor is develop/compiles op de host van uid 1000, dezelfde uid als tex in de ontwikkelomgeving (zie de opmerking in develop/pandoc/Dockerfile). Met de bovenstaande instellingen compileert de ontwikkelomgeving zonder enige wijziging van rechten.
Als je in plaats daarvan TEXLIVE_IMAGE_USER=root instelt, heeft root (uid 0) geen recht om naar de submappen van compiles te schrijven. Geef in dat geval de groep root eigendom en schrijfrechten op compiles, met setgid ingesteld zodat nieuwe submappen dit eigendom erven:
bash
services/clsi/README.md.
Gedeeld volume tussen history-v1 en filestore
De instellingen in deze en de volgende sectie staan al in
develop/docker-compose.yml en develop/dev.env. Ze zijn alleen van belang met S3_ENABLED=false in develop/dev.rc. Met de standaardwaarde S3_ENABLED=true bewaren filestore en history-v1 deze bestanden in plaats daarvan in RustFS-buckets (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history ook door de history-service gebruikt. Zo kunnen verschillende microservices dezelfde gegevens delen. Daarom koppelt de filestore-service in develop het volume history-v1-buckets van history-v1. Zonder dit volume kan clsi geen blobbestanden ophalen bij de filestore-service.
develop/docker-compose.yml
dev.env:
develop/dev.env
Submappen gebruiken
filestore leest history-blobs altijd met submappen (services/filestore/app/js/KeyBuilder.js:58, :70). De productie-image zet useSubdirectories aan voor history-v1 (server-ce/config/production.json), maar de standaardconfiguratie van history-v1 niet, dus in ontwikkeling zou history-v1 alle gegevens plat opslaan. Daarom zet dev.env NODE_CONFIG voor history-v1:
develop/dev.env
project_blobs-bestanden zo op:
useSubdirectories op true wordt de _ in deze namen een /, zodat elke blob in submappen wordt opgeslagen.
