- Dosya İzinleri Sorunu
- history-v1 ile filestore Arasında Volume Paylaşımı
- Alt Dizinler Sorunu
Sandbox Compiles’ı Etkinleştirme
Korumalı alan derlemeleri varsayılan olarak açıktır.develop/docker-compose.yml, clsi için SANDBOXED_COMPILES=true ayarlar ve geri kalanı develop/dev.env içindedir:
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (ve :2025.1) ile çekin.
LaTeX kardeş konteynerlerde TEXLIVE_IMAGE_USER olarak çalışır. Geliştirme ortamında bu tex’tir ve aynı zamanda clsi’nin varsayılanıdır (services/clsi/config/settings.defaults.cjs:154). Üretim imajı ise SANDBOXED_COMPILES_SIBLING_CONTAINERS=true olduğunda www-data kullanır (server-ce/config/env.sh:15-21), çünkü orada dosyaları Overleaf konteynerinin www-data kullanıcısı oluşturur.
Dosya İzinlerini Düzeltme
clsi konteyneri root olarak başlar,compiles, output ve cache klasörlerini node kullanıcısına (uid 1000) verir ve ardından clsi’yi node olarak çalıştırır (services/clsi/entrypoint.sh). Bu yüzden ana makinedeki develop/compiles, geliştirme ortamındaki tex ile aynı uid olan 1000’e aittir (develop/pandoc/Dockerfile içindeki yoruma bakın). Yukarıdaki ayarlarla geliştirme ortamı hiçbir izin değişikliği olmadan derler.
Bunun yerine TEXLIVE_IMAGE_USER=root ayarlarsanız root (uid 0) compiles alt klasörlerine yazma iznine sahip olmaz. Bu durumda compiles için root grubuna sahiplik ve yazma izni verin ve yeni alt klasörlerin bu sahipliği devralması için setgid ayarlayın:
bash
services/clsi/README.md dosyasına bakabilirsiniz.
history-v1 ile filestore Arasında Volume Paylaşımı
Bu bölümdeki ve bir sonraki bölümdeki ayarlar zaten
develop/docker-compose.yml ve develop/dev.env içindedir. Yalnızca develop/dev.rc içinde S3_ENABLED=false olduğunda önemlidir. Varsayılan S3_ENABLED=true ile filestore ve history-v1 bu dosyaları bunun yerine RustFS bucket’larında tutar (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history geçmiş servisi tarafından da kullanılır. Böylece farklı mikroservisler aynı verileri paylaşabilir. Bu yüzden develop’taki filestore servisi, history-v1’in history-v1-buckets birimini bağlar. Bu olmadan clsi, filestore servisinden blob dosyalarını çekemez.
develop/docker-compose.yml
dev.env içindeki şu ayarlarla bulur:
develop/dev.env
Alt Dizinleri Kullanma
filestore geçmiş blob’larını her zaman alt dizinlerle okur (services/filestore/app/js/KeyBuilder.js:58, :70). Üretim imajı history-v1 için useSubdirectories ayarını açar (server-ce/config/production.json), ancak history-v1’in varsayılan yapılandırması açmaz; bu yüzden geliştirmede history-v1 tüm verileri düzleştirirdi. Bu nedenle dev.env, history-v1 için NODE_CONFIG ayarlar:
develop/dev.env
project_blobs dosyalarını şöyle saklar:
useSubdirectories true olarak ayarlandığında bu adlardaki _ karakteri / olur, böylece her blob alt klasörlerde saklanır.
