- مشكلة أذونات الملفات
- مشاركة وحدة التخزين (Volume) بين history-v1 و filestore
- مشكلة المجلدات الفرعية
تفعيل Sandbox Compiles
الترجمة في بيئة معزولة مفعّلة افتراضيًا. يضبط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.
مشاركة وحدة التخزين (Volume) بين 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 في مجلدات فرعية.
