Siirry pääsisältöön
Hiekkalaatikkokäännökset toimivat kehitysympäristössä hieman eri tavalla kuin tuotantoimagessa. Kehitysympäristössä ne on jo määritetty; tämä sivu selittää asetukset ja kolme huomioitavaa asiaa:
  • Tiedosto-oikeusongelma
  • Volyymin jakaminen history-v1:n ja filestoren välillä
  • Alihakemisto-ongelma

Sandbox Compiles -toiminnon käyttöönotto

Hiekkalaatikkokäännökset ovat oletuksena käytössä. develop/docker-compose.yml asettaa SANDBOXED_COMPILES=true palvelulle clsi, ja develop/dev.env sisältää loput:
develop/dev.env
clsi ei hae imageja itse, joten hae imaget kerran komennolla docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (ja :2025.1). LaTeX suoritetaan sisarkonteissa käyttäjänä TEXLIVE_IMAGE_USER. Kehitysympäristössä se on tex, joka on myös clsi:n oletus (services/clsi/config/settings.defaults.cjs:154). Tuotantoimage käyttää sen sijaan käyttäjää www-data, kun SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), koska siellä tiedostot luo Overleaf-kontin www-data-käyttäjä.
Älä käytä itse rakentamaasi imagea, sillä saatat kohdata useita virheitä.

Tiedosto-oikeuksien korjaaminen

clsi-kontti käynnistyy rootina, antaa kansiot compiles, output ja cache käyttäjälle node (uid 1000) ja suorittaa sitten clsi:n käyttäjänä node (services/clsi/entrypoint.sh). Siksi isäntäkoneen develop/compiles kuuluu uid:lle 1000, samalle uid:lle kuin tex kehitysympäristössä (katso kommentti tiedostossa develop/pandoc/Dockerfile). Yllä olevilla asetuksilla kehitysympäristö kääntää ilman oikeuksien muutoksia. Jos asetat sen sijaan TEXLIVE_IMAGE_USER=root, rootilla (uid 0) ei ole oikeutta kirjoittaa compiles-kansion alikansioihin. Anna siinä tapauksessa root-ryhmälle omistajuus ja kirjoitusoikeus compiles-kansioon ja aseta setgid, jotta uudet alikansiot perivät tämän omistajuuden:
bash
Tarkemmat tiedot löydät tiedostosta services/clsi/README.md.

Volyymin jakaminen history-v1:n ja filestoren välillä

Tämän ja seuraavan osion asetukset ovat jo tiedostoissa develop/docker-compose.yml ja develop/dev.env. Niillä on merkitystä vain, kun develop/dev.rc sisältää S3_ENABLED=false. Oletusarvolla S3_ENABLED=true filestore ja history-v1 säilyttävät nämä tiedostot sen sijaan RustFS-bucketeissa (develop/s3/docker-compose.yml).
Oletusarvoisesti filestore toimii siltana S3:n ja Overleafin muiden palveluiden välillä. Overleaf CE:ssä ja Server Prossa kaikki tiedostot kuitenkin tallennetaan oletusarvoisesti paikallisesti. Siksi Overleaf otti käyttöön hyvin kekseliään menetelmän.
server-ce/config/settings.js
Samalla historiapalvelu käyttää myös data/history-hakemistoa. Näin eri mikropalvelut voivat jakaa samat tiedot. Siksi developin filestore-palvelu liittää history-v1:n history-v1-buckets-volyymin. Ilman sitä clsi ei pysty hakemaan blob-tiedostoja filestore-palvelusta.
develop/docker-compose.yml
filestore löytää bucketit näiden dev.env-asetusten avulla:
develop/dev.env

Alihakemistojen käyttäminen

filestore lukee historian blobit aina alihakemistojen kanssa (services/filestore/app/js/KeyBuilder.js:58, :70). Tuotantoimage ottaa useSubdirectories-asetuksen käyttöön history-v1:lle (server-ce/config/production.json), mutta history-v1:n oletusasetukset eivät, joten kehityksessä history-v1 litistäisi kaikki tiedot. Siksi dev.env asettaa history-v1:lle NODE_CONFIG-muuttujan:
develop/dev.env
Ilman sitä history-v1 tallentaa project_blobs-tiedostot näin:
Kun useSubdirectories on true, näiden nimien _ muuttuu muotoon /, joten jokainen blob tallennetaan alikansioihin.
Viimeksi muokattu 20. marraskuuta 2026