Přejít na hlavní obsah
Kompilace v sandboxu fungují ve vývojovém prostředí trochu jinak než v produkčním image. Vývojové prostředí je už má nastavené; tato stránka vysvětluje nastavení a tři věci, na které je třeba pamatovat:
  • Problém s oprávněními souborů
  • Sdílení svazku mezi history-v1 a filestore
  • Problém s podadresáři

Povolení kompilací v sandboxu

Kompilace v sandboxu jsou ve výchozím stavu zapnuté. develop/docker-compose.yml nastavuje SANDBOXED_COMPILES=true pro clsi a develop/dev.env obsahuje zbytek:
develop/dev.env
clsi sám image nestahuje, proto je jednou stáhněte příkazem docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (a :2025.1). LaTeX běží v sesterských kontejnerech jako TEXLIVE_IMAGE_USER. Ve vývojovém prostředí je to tex, což je také výchozí hodnota clsi (services/clsi/config/settings.defaults.cjs:154). Produkční image místo toho používá www-data, když je SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), protože tam soubory vytváří uživatel www-data kontejneru Overleaf.
Nepoužívejte prosím vlastní sestavený image, mohli byste narazit na řadu chyb.

Oprava oprávnění souborů

Kontejner clsi se spouští jako root, předá složky compiles, output a cache uživateli node (uid 1000) a pak spustí clsi jako node (services/clsi/entrypoint.sh). Proto develop/compiles na hostiteli patří uid 1000, stejnému uid jako tex ve vývojovém prostředí (viz komentář v develop/pandoc/Dockerfile). S výše uvedeným nastavením vývojové prostředí kompiluje bez jakékoli změny oprávnění. Pokud místo toho nastavíte TEXLIVE_IMAGE_USER=root, root (uid 0) nemá oprávnění zapisovat do podsložek compiles. V takovém případě dejte skupině root vlastnictví a právo zápisu ke compiles a nastavte setgid, aby nové podsložky toto vlastnictví zdědily:
bash
Podrobnou dokumentaci najdete v services/clsi/README.md.

Sdílení svazku mezi history-v1 a filestore

Nastavení v této a následující sekci už jsou v develop/docker-compose.yml a develop/dev.env. Mají význam jen při S3_ENABLED=false v develop/dev.rc. S výchozím S3_ENABLED=true ukládají filestore a history-v1 tyto soubory místo toho do bucketů RustFS (develop/s3/docker-compose.yml).
Ve výchozím nastavení slouží filestore jako most mezi S3 a ostatními službami Overleafu. V Overleaf CE nebo Server Pro se však všechny soubory ve výchozím stavu ukládají lokálně. Overleaf proto zavedl velmi důmyslný postup.
server-ce/config/settings.js
Zároveň data/history používá i služba historie. Takto mohou různé mikroslužby sdílet stejná data. Proto služba filestore v develop připojuje svazek history-v1-buckets ze služby history-v1. Bez něj clsi nebude moci stahovat blob soubory ze služby filestore.
develop/docker-compose.yml
filestore najde buckety pomocí těchto nastavení v dev.env:
develop/dev.env

Použití podadresářů

filestore vždy čte bloby historie s podadresáři (services/filestore/app/js/KeyBuilder.js:58, :70). Produkční image zapíná useSubdirectories pro history-v1 (server-ce/config/production.json), ale výchozí konfigurace history-v1 ne, takže ve vývoji by history-v1 všechna data zploštil. Proto dev.env nastavuje NODE_CONFIG pro history-v1:
develop/dev.env
Bez toho history-v1 ukládá soubory project_blobs takto:
S useSubdirectories nastaveným na true se _ v těchto názvech změní na /, takže každý blob se uloží do podsložek.
Naposledy změněno 20. listopadu 2026