ترقية Drupal

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

ترقية نظام Drupal الأساسي

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

ملاحظات:

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

    في حال الترقية إلى Private Cloud (على سبيل المثال، من 4.18.05 إلى 4.19.01)، يجب تحديث Apigee. تعمل الأداة على الرجوع إلى إصدار سابق من Drupal، قد تحتاج إلى إعادة تشغيل أداة ترقية Drupal. لمزيد من المعلومات، يُرجى مراجعة أعِد إجراء ترقية 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 Support وقدِّم أي رسائل خطأ تم الإبلاغ عنها أثناء التحديث.