- 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
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ä.
Tiedosto-oikeuksien korjaaminen
clsi-kontti käynnistyy rootina, antaa kansiotcompiles, 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
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).server-ce/config/settings.js
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
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
project_blobs-tiedostot näin:
useSubdirectories on true, näiden nimien _ muuttuu muotoon /, joten jokainen blob tallennetaan alikansioihin.
