- Masalah izin file
- Berbagi volume antara history-v1 dan filestore
- Masalah subdirektori
Mengaktifkan Sandbox Compiles
Kompilasi sandbox aktif secara default.develop/docker-compose.yml menetapkan SANDBOXED_COMPILES=true untuk clsi, dan develop/dev.env berisi sisanya:
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (dan :2025.1).
LaTeX berjalan di container saudara sebagai TEXLIVE_IMAGE_USER. Di lingkungan pengembangan, nilainya tex, yang juga merupakan default clsi (services/clsi/config/settings.defaults.cjs:154). Image produksi menggunakan www-data sebagai gantinya ketika SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), karena di sana file dibuat oleh pengguna www-data dari container Overleaf.
Memperbaiki Izin File
Container clsi dimulai sebagai root, memberikan foldercompiles, output, dan cache kepada pengguna node (uid 1000), lalu menjalankan clsi sebagai node (services/clsi/entrypoint.sh). Jadi develop/compiles di host dimiliki oleh uid 1000, uid yang sama dengan tex di lingkungan pengembangan (lihat komentar di develop/pandoc/Dockerfile). Dengan pengaturan di atas, lingkungan pengembangan mengompilasi tanpa perubahan izin apa pun.
Jika Anda menetapkan TEXLIVE_IMAGE_USER=root sebagai gantinya, root (uid 0) tidak memiliki izin menulis ke subfolder compiles. Dalam hal itu, berikan grup root kepemilikan dan izin menulis pada compiles, dengan setgid diaktifkan agar subfolder baru mewarisi kepemilikan ini:
bash
services/clsi/README.md.
Berbagi Volume antara history-v1 dan filestore
Pengaturan di bagian ini dan bagian berikutnya sudah ada di
develop/docker-compose.yml dan develop/dev.env. Pengaturan ini hanya berpengaruh dengan S3_ENABLED=false di develop/dev.rc. Dengan default S3_ENABLED=true, filestore dan history-v1 menyimpan file ini di bucket RustFS sebagai gantinya (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history juga digunakan oleh layanan riwayat. Dengan cara ini, berbagai microservice dapat berbagi data yang sama. Itulah sebabnya layanan filestore di develop memasang volume history-v1-buckets milik history-v1. Tanpa volume itu, clsi tidak akan dapat menarik file blob dari layanan filestore.
develop/docker-compose.yml
dev.env:
develop/dev.env
Menggunakan Subdirektori
filestore selalu membaca blob riwayat dengan subdirektori (services/filestore/app/js/KeyBuilder.js:58, :70). Image produksi mengaktifkan useSubdirectories untuk history-v1 (server-ce/config/production.json), tetapi konfigurasi default history-v1 tidak, sehingga dalam pengembangan history-v1 akan meratakan semua data. Karena itu dev.env menetapkan NODE_CONFIG untuk history-v1:
develop/dev.env
project_blobs seperti ini:
useSubdirectories bernilai true, _ dalam nama-nama ini menjadi /, sehingga setiap blob disimpan dalam subfolder.
