Ana içeriğe atla
Korumalı alan derlemeleri geliştirme ortamında üretim imajından biraz farklı çalışır. Geliştirme ortamında bunlar zaten ayarlanmıştır; bu sayfa ayarları ve akılda tutulması gereken üç noktayı açıklar:
  • 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
clsi imajları kendisi çekmez, bu yüzden imajları bir kez 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.
Lütfen kendi oluşturduğunuz imajı kullanmayın, bir dizi hatayla karşılaşabilirsiniz.

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
Ayrıntılı dokümantasyon için 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).
Varsayılan olarak filestore, Overleaf’te s3 ile diğer servisler arasında bir köprü görevi görür. Ancak Overleaf CE veya Server Pro’da tüm dosyalar varsayılan olarak yerel olarak depolanır. Bu nedenle Overleaf oldukça dolambaçlı bir yöntem getirmiştir.
server-ce/config/settings.js
Bu arada 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
filestore, bucket’ları 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
Bu olmadan history-v1, project_blobs dosyalarını şöyle saklar:
useSubdirectories true olarak ayarlandığında bu adlardaki _ karakteri / olur, böylece her blob alt klasörlerde saklanır.
Son değiştirilme tarihi 20 Kasım 2026