الترحيل إلى S3
منذ الإصدار v6.0.0، لم يعد Ayakaleaf Pro يستخدم التخزين القديم
user_files، لذا لا يلزم ترحيل سوى ملفات القوالب والسجل.يسعدنا أن نسمع منك! إذا كنت ترغب في مشاركتنا عدد الملفات التي رحّلتها، وحجمها الإجمالي، والمدة التي استغرقها الترحيل، فراسلنا عبر البريد الإلكتروني
ayaka@outlook.in .المتطلبات
- تخزين كائنات متوافق مع S3 للتواصل معه، راجع #s3-setup للاطلاع على الخيارات
- مساحة قرص فارغة لترحيل البيانات الحالية، تعادل تقريبًا الحجم الحالي على القرص
- فترة صيانة لإجراء الترحيل الفعلي
- نسخة احتياطية كاملة، بما في ذلك الإعدادات، لتمكين الاستعادة منها
تقدير مساحة القرص اللازمة للترحيل
يمكننا استخدامdu لحساب استخدام القرص الحالي:
تتمتع مجلدات السجل (history) بالبنية الصحيحة مسبقًا. يمكنك الرفع مباشرةً من مجلد المصدر المربوط (bind-mounted)، وهو ما لا يتطلب أي مساحة قرص إضافية.
خطوات الترحيل
الخطوة 0: إيقاف المثيل
نحتاج إلى التأكد من ترحيل جميع ملفات المستخدمين/القوالب. ومن الأفضل إيقاف المثيل لتجنب فقدان الملفات المرفوعة حديثًا. يُرجى الاطلاع على دليلنا حول إجراء نسخ احتياطي متّسق لمعرفة إجراءات الإيقاف.الخطوة 1: إعادة كتابة بنية المجلدات
نحتاج إلى إعادة كتابة بنية مجلدات ملفات القوالب لرفعها إلى S3. يحتفظ Filestore بملفات القوالب في دليل مسطّح واحد، مثل<template-id>_v_1_pdf، بينما يستخدم S3 الصيغة <template-id>/v/1/pdf.
فيما يلي، يُستخدم /srv/overleaf-s3-migration لتخزين الملفات بالبنية الجديدة للمجلدات. استبدل /srv/overleaf-bind-mount بمجلد المضيف المربوط بالمسار /var/lib/overleaf. شغّل أوامر النسخ على المضيف بصلاحيات تتيح قراءة هذه المجلدات والكتابة فيها؛ وتبقى الحاوية متوقفة.
يمكننا الاستفادة من tar لإعادة كتابة البنية:
الخطوة 2: رفع الملفات
بحسب تفضيلك، يمكنك استخدام عميل S3 minio mc أو aws cli لرفع الملفات إلى تخزين الكائنات المتوافق مع S3 لديك. aws cli- هنا يجب أن تستبدل
overleaf-template-filesوoverleaf-project-blobsوoverleaf-chunksبأسماء حاويات S3 (buckets) الخاصة بك. - واستبدل أيضًا
/srv/overleaf-bind-mountبالمسار المحلي لربط/var/lib/overleaf. افتراضيًا، يكون هذا~/overleaf_dataفي نشر docker-compose.yml، و<toolkit-checkout>/data/overleafعند استخدام Toolkit.
الخطوة 3: تشغيل المثيل بحيث يشير إلى S3
أضف جميع المتغيرات المتعلقة بـ S3 إلى إعداداتك، كما هو مفصّل في قسم نظرة عامة على المتغيرات في دليل إعداد S3. أبقِ على ربط مجلد البيانات: فقد يحتوي أيضًا على مفاتيح تشفير Zotero أو Mendeley التي لا تُرحَّل إلى S3.يُرجى الإبقاء على ربط قرص مؤقت للملفات العابرة (bind-mount) كما هو، راجع تشغيل Overleaf باستخدام نظام ملفات NFS في استكشاف الأخطاء وإصلاحها.
- إمكانية معاينة الملفات الثنائية في المحرر
- إمكانية ترجمة ملف PDF يحتوي على صور
- إمكانية رفع ملفات جديدة
التراجع
يمكنك التراجع عن الترحيل بسلاسة بعكس الخطوات:- أوقف المثيل
- انسخ الملفات مرة أخرى بعكس ترتيب المصدر/الوجهة
- اكتب الملفات الجديدة مرة أخرى في المجلد المحلي باستخدام
transformمعكوس - أعد تشغيل المثيل بالإعدادات القديمة
يزيل التحويل الأول المجلد ذا المستوى الأعلى. ويغيّر التحويل الثاني بنية المجلدات إلى بنية مسطحة. وتضمن أنماط البدل (wildcards) استخراج الملفات فقط، دون المجلدات الأم (مجلدات المشاريع).

