- Problem mit Dateiberechtigungen
- Gemeinsames Volume zwischen history-v1 und filestore
- Problem mit Unterverzeichnissen
Sandbox-Kompilierung aktivieren
Sandbox-Kompilierungen sind standardmäßig aktiviert.develop/docker-compose.yml setzt SANDBOXED_COMPILES=true für clsi, und develop/dev.env enthält den Rest:
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (und :2025.1) herunter.
LaTeX läuft in den Geschwister-Containern als TEXLIVE_IMAGE_USER. In der Entwicklungsumgebung ist das tex, was auch der Standard von clsi ist (services/clsi/config/settings.defaults.cjs:154). Das Produktions-Image verwendet stattdessen www-data, wenn SANDBOXED_COMPILES_SIBLING_CONTAINERS=true gesetzt ist (server-ce/config/env.sh:15-21), weil dort die Dateien vom Benutzer www-data des Overleaf-Containers erstellt werden.
Dateiberechtigungen korrigieren
Der clsi-Container startet als root, übergibt die Ordnercompiles, output und cache an den Benutzer node (uid 1000) und führt clsi dann als node aus (services/clsi/entrypoint.sh). Daher gehört develop/compiles auf dem Host der uid 1000, derselben uid wie tex in der Entwicklungsumgebung (siehe den Kommentar in develop/pandoc/Dockerfile). Mit den obigen Einstellungen kompiliert die Entwicklungsumgebung ohne jede Änderung der Berechtigungen.
Wenn Sie stattdessen TEXLIVE_IMAGE_USER=root setzen, hat root (uid 0) keine Berechtigung, in die Unterordner von compiles zu schreiben. Geben Sie in diesem Fall der Gruppe root den Besitz und Schreibrechte für compiles und setzen Sie setgid, damit neue Unterordner diesen Besitz erben:
bash
services/clsi/README.md.
Gemeinsames Volume zwischen history-v1 und filestore
Die Einstellungen in diesem und dem nächsten Abschnitt sind bereits in
develop/docker-compose.yml und develop/dev.env enthalten. Sie spielen nur mit S3_ENABLED=false in develop/dev.rc eine Rolle. Mit dem Standard S3_ENABLED=true legen filestore und history-v1 diese Dateien stattdessen in RustFS-Buckets ab (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history auch vom History-Dienst verwendet. Auf diese Weise können verschiedene Microservices dieselben Daten gemeinsam nutzen. Deshalb bindet der filestore-Dienst in develop das Volume history-v1-buckets von history-v1 ein. Ohne dieses Volume kann clsi keine Blob-Dateien vom filestore-Dienst abrufen.
develop/docker-compose.yml
dev.env:
develop/dev.env
Unterverzeichnisse verwenden
filestore liest History-Blobs immer mit Unterverzeichnissen (services/filestore/app/js/KeyBuilder.js:58, :70). Das Produktions-Image schaltet useSubdirectories für history-v1 ein (server-ce/config/production.json), die Standardkonfiguration von history-v1 jedoch nicht, sodass history-v1 in der Entwicklung alle Daten flach ablegen würde. dev.env setzt daher NODE_CONFIG für history-v1:
develop/dev.env
project_blobs-Dateien so:
useSubdirectories auf true gesetzt ist, wird der _ in diesen Namen zu /, sodass jeder Blob in Unterordnern gespeichert wird.
