من المهم التأكد من أخذ نسخة احتياطية متسقة قبل كل ترقية لإصدار رئيسي، حتى تتمكن من التراجع إذا احتجت إلى ذلك.
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.يُرجى الاطلاع هنا لمزيد من المعلومات حول النشر في البيئات المعزولة عن الشبكة/غير المتصلة.