من المهم التأكد من أخذ نسخة احتياطية متسقة قبل كل ترقية لإصدار رئيسي، حتى تتمكن من التراجع إذا احتجت إلى ذلك.
bin/upgrade واتباع التعليمات التي تظهر على الشاشة.
تجدر الإشارة إلى أن إصدار صورة Docker (في config/version) يُدار بشكل منفصل عن تحديثات شيفرة Toolkit. تحديث شيفرة Toolkit لن يغيّر تلقائيًا إصدار صورة Docker التي تشغّلها. وهذا يعني أنه في معظم الحالات يمكنك ترقية إصدار Toolkit دون ترقية عملية النشر.
السكربت bin/upgrade
عند تشغيل الأمر bin/upgrade، سيتحقق السكربت مما إذا كان هناك تحديث متاح لشيفرة Toolkit، وسيعرض عليك تحديث Toolkit. يمكنك دائمًا رفض هذه الترقية، ولن يتغير شيء.
إذا اخترت تحديث شيفرة Toolkit، فسيتحقق السكربت بعد ذلك مما إذا كان إصدار صورة Docker الافتراضي قد تغيّر، وسيعرض عليك ترقية ملف الإصدار المحلي (في config/version) ليطابق الإصدار الافتراضي الجديد.
إذا اخترت تبديل الإصدارات، فسيرشدك السكربت بعد ذلك خلال عملية إيقاف خدمات Docker، وأخذ نسخة احتياطية، ثم إعادة تشغيل خدمات Docker. سيُنسخ ملف الإصدار القديم تلقائيًا إلى config/__old-version، تحسبًا لحاجتك إلى التراجع إلى ذلك الإصدار من صور Docker.
بالنسبة للبيئات المعزولة عن الشبكة (air-gapped) التي تستورد صور Docker يدويًا، يُرجى ضبط
PULL_BEFORE_UPGRADE=false في ملف config/overleaf.rc.يُرجى الاطلاع هنا لمزيد من المعلومات حول النشر في البيئات المعزولة عن الشبكة/غير المتصلة.مسار الترقية
إذا كنت تشغّل إصدارًا أقدم من Overleaf Community سابقًا للإصدار v6.0.0، فارجع إلى وثائق Overleaf الرسمية لإكمال الترقية. داخل Ayakaleaf Pro، قم بالترقية أولًا إلى أحدث إصدار تصحيحي (patch) من خط الإصدار الحالي لديك، ثم إلى الخط التالي، على سبيل المثال6.2.0 → 6.2.2 → 6.3.2. اقرأ ملاحظات الإصدار لكل إصدار تمر به، فبعضها يتطلب خطوات إضافية. أحدث إصدار فقط هو المدعوم.
للتحقق من الصورة التي تشغّلها، استخدم
docker inspect --format '{{.Config.Image}}' sharelatex.
أسئلة وأجوبة
ما وظيفة السكربت upgrade-user-features؟
ما وظيفة السكربت upgrade-user-features؟
الإجابة: يمنح المستخدمين الحاليين الميزات الافتراضية لنسختك، مثل مهلة الترجمة التي يحددها
COMPILE_TIMEOUT. وهو يرفع القيم فقط ولا يخفّضها أبدًا، لذا يحتفظ المستخدم الذي لديه مهلة ترجمة أطول بها. وهو ليس جزءًا من الترقية ولا يعمل من تلقاء نفسه أبدًا؛ ولا تحتاج إليه إلا بعد رفع قيمة افتراضية مثل COMPILE_TIMEOUT. افتراضيًا، يعمل في وضع التجربة (dry run) فيسرد المستخدمين الذين سيغيّرهم؛ أضف --dry-run=false لحفظ التغييرات:
