الانتقال إلى المحتوى الرئيسي
تعمل الترجمة في بيئة معزولة بشكل مختلف قليلًا في بيئة التطوير عنها في صورة الإنتاج. بيئة التطوير مُعدّة لها مسبقًا؛ وتشرح هذه الصفحة الإعدادات وثلاثة أمور يجب مراعاتها:
  • مشكلة أذونات الملفات
  • مشاركة وحدة التخزين (Volume) بين history-v1 و filestore
  • مشكلة المجلدات الفرعية

تفعيل Sandbox Compiles

الترجمة في بيئة معزولة مفعّلة افتراضيًا. يضبط develop/docker-compose.yml القيمة SANDBOXED_COMPILES=true للخدمة clsi، ويحتوي develop/dev.env على الباقي:
develop/dev.env
لا يسحب clsi الصور بنفسه، لذا اسحب الصور مرة واحدة باستخدام 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).
افتراضيًا، تعمل filestore كجسر بين s3 والخدمات الأخرى في overleaf. لكن في overleaf ce أو server pro، تُخزَّن جميع الملفات محليًا بشكل افتراضي. ولذلك اعتمدت overleaf طريقة ملتوية جدًا.
server-ce/config/settings.js
وفي الوقت نفسه، تستخدم خدمة السجل أيضًا data/history. وبهذه الطريقة يمكن للخدمات المصغرة المختلفة مشاركة البيانات نفسها. ولهذا تربط خدمة filestore في develop وحدة التخزين history-v1-buckets الخاصة بـ history-v1. وبدونها لن يتمكن clsi من سحب ملفات blob من خدمة filestore.
develop/docker-compose.yml
يعثر filestore على الحاويات عبر هذه الإعدادات في 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
وبدونها يخزّن history-v1 ملفات project_blobs هكذا:
عند ضبط useSubdirectories على true يصبح _ في هذه الأسماء /، فيُخزَّن كل blob في مجلدات فرعية.
آخر تعديل في ٢٠ نوفمبر ٢٠٢٦