في عملية تثبيت Edge for Private Cloud لبوابة خدمات مطوّري Apigee (أو ببساطة، البوابة)، قد تتلقّى إشعارًا بأنّ إصدارًا جديدًا من Drupal متاح. يمكن أن يشير الإصدار الجديد إلى إصدار ميزة في Drupal أو تصحيح أو تحديث أمان أو نوع آخر من تحديثات Drupal. في حال توفّر تحديث أمان، عليك ترقية إصدار Drupal في أقرب وقت ممكن لضمان بقاء موقعك الإلكتروني آمنًا.
ترقية نواة Drupal
يوضّح الإجراء أدناه كيفية تحديث تثبيت Private Cloud من Drupal 7.x.y إلى رقم إصدار ثانوي آخر (على سبيل المثال، Drupal 7.54 إلى 7.59).
يُرجى مراعاة ما يلي:
-
يؤدي هذا الإجراء إلى تحديث تثبيت Drupal فقط. ولا يؤدي إلى تحديث برنامج Apigee الذي يتم شحنه كجزء من البوابة. للحصول على معلومات حول ترقية برنامج بوابة Apigee، يُرجى الاطّلاع على ترقية البوابة.
إذا كانت أداة تحديث Apigee تُرجع إصدار Drupal إلى إصدار سابق أثناء ترقية Private Cloud (على سبيل المثال، من 4.18.05 إلى 4.19.01)، قد تحتاج إلى إعادة تشغيل أداة ترقية Drupal. لمزيد من المعلومات، يُرجى الاطّلاع على إعادة تشغيل ترقية Drupal.
- يجب تنفيذ أوامر Drush (Drupal Shell) من الدليل الجذري لموقع المدخل الإلكتروني. يتم تثبيت البوابة تلقائيًا في:
-
/opt/apigee/apigee-drupal/wwwroot(Nginx) /var/www/html(Apache)
-
تحديد إصدار Drupal الحالي
قبل بدء تحديث Drupal، يمكنك تحديد إصدار Drupal الحالي من خلال تشغيل
الأمر التالي من مجلد تثبيت Drupal. يتم تثبيت Drupal تلقائيًا في
/opt/apigee/apigee-drupal/wwwroot:
cd /opt/apigee/apigee-drupal/wwwroot
drush status | grep 'Drupal version'
من المفترض أن تظهر لك النتيجة بالشكل التالي:
Drupal version : 7.54
إذا ثبّتّ Drupal في دليل آخر غير /opt/apigee/apigee-drupal/wwwroot،
تأكَّد من التغيير إلى هذا الدليل قبل تشغيل الأمر drush.
تحديث إصدار Drupal
يوضّح هذا القسم كيفية استخدام أوامر Drush من سطر الأوامر لتحديث إصدار Drupal. يمكنك أيضًا الاطّلاع على تحديث Drupal باستخدام Drush (Drupal.org).
لتحديث تثبيت Drupal:
- انتقِل إلى الدليل
/opt/apigee/apigee-drupal/wwwrootأو الدليل الذي ثبّتّ فيه البوابة الإلكترونية. - احتفِظ بالاحتفاظ الكامل بنسخة احتياطية من جميع الملفات والأدلة وقواعد البيانات. احفظ النسخة الاحتياطية في موقع جغرافي
خارج تثبيت Drupal. للحصول على التعليمات الكاملة، يُرجى الاطّلاع على مقالة الاحتفاظ بنسخة احتياطية من البوابة.
إذا أجريت تعديلات على ملفات مثل
.htaccessأوrobots.txtأوdefaults.settings.php(في دليلsites)، عليك إعادة تطبيق التغييرات بعد التحديث. وسيكون عليك أيضًا إعادة تطبيق أي تخصيصات تم إجراؤها في دليلsites/all. - ضبط موقعك الإلكتروني على وضع الصيانة:
drush vset --exact maintenance_mode 1
drush cache-clear all
- ثبِّت الإصدار المطلوب من Drupal باستخدام الأمر التالي:
drush pm-update drupal-version
يمثّل العنصر version الإصدار المطلوب.
بدلاً من ذلك، يمكنك تشغيل
drush pm-update drupalللتحديث إلى أحدث إصدار من Drupal core. يمكنك تشغيلdrush pm-updatestatusلإدراج التحديثات الثانوية المتاحة لمشاريع Drupal الأساسية والمساهمة. - أعِد تطبيق أي تغييرات تم إجراؤها على
.htaccessأوrobots.txtأوdefaults.settings.php(في دليلsites). - أعِد تطبيق أي تغييرات تم إجراؤها على دليل
sites/all. - إيقاف وضع الصيانة في موقعك الإلكتروني:
drush vset --exact maintenance_mode 0
drush cache-clear all
ترقية PHP ووحدات Drupal contrib
عند ترقية Drupal باستخدام التعليمات الواردة أعلاه في هذا القسم، تتم أيضًا ترقية الوحدات التي يستخدمها Drupal، مثل contrib وPHP. ومع ذلك، يجب مواكبة أحدث وحدات Drupal بين إصدارات Private Cloud.
يُرجى العِلم أنّه إذا كانت الوحدة في /profiles/apigee/modules/contrib، يمكنك استبدالها
بإصدار أحدث من تلك الوحدة من خلال تخزين الإصدار الأحدث في
/sites/all/modules/contrib. يستخدم Edge for Private Cloud الإصدار الأحدث في
/sites/all/modules/contrib بدلاً من الإصدار الأقدم في
/profiles/apigee/modules/contrib. لمزيد من المعلومات، يُرجى الاطّلاع على تحديث الوحدات (Drupal.org).
إذا ثبّت إصدارًا جديدًا من Private Cloud يتضمّن إصدارًا أحدث من الوحدة
التي تم تخزينها سابقًا في /sites/all/modules/contrib، عليك إزالة الوحدة من
/sites/all/modules/contrib. لمزيد من المعلومات، يُرجى الاطّلاع على
نقل
الوحدات والمظاهر (Drupal.org).
ماذا لو واجهتني مشكلة أثناء التحديث؟
استعِد موقعك الإلكتروني إلى حالته السابقة باستخدام ملفات النُسخ الاحتياطية التي أنشأتها. يُرجى التواصل مع فريق دعم Apigee Edge وتقديم أي رسائل خطأ تم الإبلاغ عنها أثناء التحديث.