الانتقال إلى المحتوى الرئيسي
يعمل Ayakaleaf Pro على خادم بنواتَي معالج وذاكرة 2 GB، بما في ذلك تكامل Git، بمجرد إضافة 2 GB من مساحة التبديل (swap). من دون swap تنفد ذاكرته أثناء بدء التشغيل. ثم تخفّض الإعدادات في الخطوة 2 استخدام swap إلى النصف تقريبًا.
قسنا ذلك على Ayakaleaf Pro 6.3.1 مع Toolkit، في آلة افتراضية QEMU/KVM بمواصفات 2 vCPU / 2 GiB تعمل بنظام Ubuntu 24.04، مع تفعيل الترجمة في بيئة معزولة (texlive-basic:2025.1) وتكامل Git.

لماذا لا تكفي 2 GB افتراضيًا

في وضع الخمول ومع الإعدادات الافتراضية، يحتاج Ayakaleaf Pro إلى نحو 1.9 GiB. يستخدم Ubuntu وDocker بالفعل 364 MiB من آلة بسعة 2 GiB، فيتبقى نحو 1600 MiB.

  1. أضف 2 GB من swap

هذه هي الخطوة الأهم.

  1. خفّض استخدام الذاكرة

أضف هذه الأسطر إلى config/variables.env. تقرأ حاوية تكامل Git هذا الملف أيضًا.
variables.env
لتحديد سقف للذاكرة المؤقتة لـ MongoDB، أضف إدخال mongo تحت services في config/docker-compose.override.yml (الملف نفسه الذي يحدد صورة Ayakaleaf Pro):
docker-compose.override.yml
ثم شغّل bin/up -d.
يستبدل NODE_OPTIONS القيمة المعيّنة في الصورة، لذا يجب أن يحتفظ السطر بـ --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs. من دونهما لا تستطيع خدمات Node.js تحميل حزمها ولا تبدأ. لا يمكن استخدام --optimize-for-size: إذ يرفضه Node.js في NODE_OPTIONS.--replSet overleaf هو ما يمرّره Toolkit إلى MongoDB افتراضيًا. احتفظ به.
مع heap بحجم 160 MiB، قد يؤدي استنساخ مشروع كبير أو دفعه عبر Git إلى نفاد الذاكرة، فتُعاد تشغيل حاوية تكامل Git. لم نختبر ذلك. إذا حدث، فارفع قيمة -Xmx.

النتائج

ترجم كل اختبار مستند LuaLaTeX من 33 صفحة يستخدم fontspec و30 شكلًا من TikZ؛ وكانت عمليات الترجمة المتزامنة لمشاريع مختلفة. من دون swap، يؤدي إنهاء واحد بسبب نفاد الذاكرة إلى التالي: يُعاد تشغيل web، ويحتاج بدء تشغيله إلى الذاكرة مجددًا، ويتوقف الخادم عن الاستجابة حتى إعادة ضبط قسرية. مع swap، تستغرق ثلاث ترجمات متزامنة وقتًا يقارب ترجمة واحدة، لأن ما يُنقل إلى swap هو صفحات Node.js الخاملة. لم يُختبر: حمل استنساخ Git والدفع، وكثرة المستخدمين الذين يحررون في الوقت نفسه، وswap على أقراص بطيئة (استخدم مضيفنا قرص SSD).

Kubernetes

يعطّل دليل Kubernetes الخاص بنا swap على العقد (تجهيز العقد)، لذا لا تنطبق هناك إلا الخطوة 2. ضع NODE_OPTIONS وMALLOC_ARENA_MAX في ConfigMap المسمّى overleaf-env (تخصيص المثيل الخاص بك). الذاكرة المؤقتة لـ MongoDB مضبوطة بالفعل في نشر MongoDB وRedis.
آخر تعديل في ٢١ نوفمبر ٢٠٢٦