- Проблема з правами доступу до файлів
- Спільний том для history-v1 та filestore
- Проблема з підкаталогами
Увімкнення ізольованої компіляції
Компіляцію в пісочниці ввімкнено за замовчуванням.develop/docker-compose.yml задає SANDBOXED_COMPILES=true для clsi, а develop/dev.env містить решту:
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (і :2025.1).
LaTeX працює в сусідніх контейнерах від імені TEXLIVE_IMAGE_USER. У середовищі розробки це tex, що також є значенням за замовчуванням для clsi (services/clsi/config/settings.defaults.cjs:154). Продакшн-образ натомість використовує www-data, коли SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), бо там файли створює користувач www-data контейнера Overleaf.
Виправлення прав доступу до файлів
Контейнер clsi запускається від root, передає текиcompiles, output і cache користувачеві node (uid 1000), а потім запускає clsi від імені node (services/clsi/entrypoint.sh). Тому develop/compiles на хості належить uid 1000, тому самому uid, що й у tex у середовищі розробки (див. коментар у develop/pandoc/Dockerfile). З наведеними вище налаштуваннями середовище розробки компілює без жодних змін прав.
Якщо натомість задати TEXLIVE_IMAGE_USER=root, root (uid 0) не має права записувати в підтеки compiles. У такому разі надайте групі root володіння та право запису на compiles і встановіть setgid, щоб нові підтеки успадковували це володіння:
bash
services/clsi/README.md.
Спільний том для history-v1 та filestore
Налаштування з цього й наступного розділу вже є в
develop/docker-compose.yml і develop/dev.env. Вони мають значення лише за S3_ENABLED=false у develop/dev.rc. За значення за замовчуванням S3_ENABLED=true filestore і history-v1 зберігають ці файли в бакетах RustFS (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history використовує й сервіс історії. Так різні мікросервіси можуть спільно використовувати ті самі дані. Тому сервіс filestore у develop монтує том history-v1-buckets сервісу history-v1. Без нього clsi не зможе отримувати blob-файли із сервісу filestore.
develop/docker-compose.yml
dev.env:
develop/dev.env
Використання підкаталогів
filestore завжди читає blob-об’єкти історії з підкаталогами (services/filestore/app/js/KeyBuilder.js:58, :70). Продакшн-образ вмикає useSubdirectories для history-v1 (server-ce/config/production.json), а типова конфігурація history-v1 ні, тому в розробці history-v1 зробив би всі дані пласкими. Тож dev.env задає NODE_CONFIG для history-v1:
develop/dev.env
project_blobs так:
useSubdirectories дорівнює true, символ _ у цих назвах стає /, тож кожен blob зберігається у вкладених теках.
