ترقية Drupal

عند تثبيت بوابة خدمات مطوّري برامج Apigee على Edge for Private Cloud (أو البوابة)، قد تتلقّى إشعارًا بتوفّر إصدار جديد من Drupal. وقد يعني الإصدار الجديد إصدار ميزة من Drupal أو رمز تصحيح أو تحديث أمان أو أي نوع آخر من تحديثات Drupal. في حال إجراء تحديث أمان، ستحتاج إلى ترقية تثبيت Drupal في أقرب وقت ممكن لضمان الحفاظ على أمان موقعك الإلكتروني.

ترقية Drupal Core

يشرح الإجراء أدناه كيفية تحديث تثبيت Drupal 7.x.y على السحابة الإلكترونية الخاصة إلى إصدار ثانوي آخر (على سبيل المثال، Drupal 7.54 إلى 7.59).

ملاحظات:

  • يحدِّث هذا الإجراء تثبيت Drupal فقط. ولا يؤدي هذا الإجراء إلى تحديث برنامج Apigee الذي يتم شحنه كجزء من البوابة. للحصول على معلومات حول ترقية برنامج بوابة Apigee، يمكنك الاطّلاع على ترقية البوابة.

    إذا كانت أداة تحديث Apigee تعمل على خفض مستوى إصدار Drupal إلى إصدار سابق أثناء إجراء ترقية Private Cloud (على سبيل المثال، من 4.18.05 إلى 4.19.01)، قد تحتاج إلى إعادة تشغيل الأداة. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على إعادة تشغيل ترقية Drupal.

  • عليك تنفيذ أوامر Drush (Drupal Shell) من الدليل الجذر لموقع البوابة. يتم تثبيت البوابة تلقائيًا على:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    يفترض الإجراء أدناه تثبيت خادم Nginx في الموقع التلقائي أعلاه.

تحديد إصدار 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:

  1. انتقِل إلى الدليل /opt/apigee/apigee-drupal/wwwroot أو الدليل الذي تم تثبيت البوابة فيه.
  2. عمل نسخة احتياطية كاملة من جميع الملفات والأدلة وقواعد البيانات. احفظ النسخة الاحتياطية في مكان خارج تثبيت Drupal. للحصول على التعليمات الكاملة، راجِع الاحتفاظ بنسخة احتياطية من بيانات البوابة.

    إذا أجريت تعديلات على ملفات مثل .htaccess أو robots.txt أو defaults.settings.php (في دليل sites)، سيكون عليك إعادة تطبيق التغييرات بعد عملية التعديل. وسيكون عليك أيضًا إعادة تطبيق أي عمليات تخصيص تم إجراؤها في دليل sites/all.

  3. ضبط موقعك الإلكتروني في وضع الصيانة:
    drush vset --exact maintenance_mode 1
    drush cache-clear all
  4. ثبِّت الإصدار المطلوب من Drupal باستخدام الأمر التالي:
    drush pm-update drupal-version

    تمثّل هذه السمة version النسخة المطلوبة.

    بدلاً من ذلك، يمكنك تشغيل drush pm-update drupal للتحديث إلى أحدث إصدار من Drupal الأساسي. يمكنك تنفيذ drush pm-updatestatus لعرض التحديثات الثانوية المتاحة لمشاريع Drupal الأساسية والمساهمة.

  5. أعِد تطبيق أي تغييرات تم إجراؤها على .htaccess أو robots.txt أو defaults.settings.php (في دليل sites).
  6. أعِد تطبيق أي تغييرات تم إجراؤها على دليل sites/all .
  7. أوقِف وضع الصيانة على موقعك الإلكتروني:
    drush vset --exact maintenance_mode 0
    drush cache-clear all

ترقية وحدات المشاركة بلغة PHP وDupal

عند ترقية 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).

في حال تثبيت إصدار جديد من "السحابة الإلكترونية الخاصة" يتضمّن إصدارًا أحدث من الوحدة التي تم تخزينها سابقًا في "/sites/all/modules/contrib"، عليك إزالة الوحدة من "/sites/all/modules/contrib". لمزيد من المعلومات، يمكنك الاطّلاع على نقل الوحدات والمظاهر (Drupal.org).

ماذا لو واجهتُ مشكلة أثناء التحديث؟

استعادة موقعك الإلكتروني إلى حالته السابقة باستخدام ملفات النسخة الاحتياطية التي أنشأتها. يُرجى التواصل مع فريق دعم Apigee Edge وتقديم أي رسائل خطأ تم الإبلاغ عنها أثناء التحديث.