ارتقا دادن Drupal

در نصب Edge for Private Cloud از درگاه «خدمات توسعه‌دهندگان Apigee» (یا به‌سادگی، درگاه)، ممکن است اعلانی دریافت کنید که نسخه جدیدی از Drupal دردسترس است. نسخه جدید می‌تواند به معنای انتشار ویژگی Drupal، وصله، به‌روزرسانی امنیتی، یا نوع دیگری از به‌روزرسانی Drupal باشد. درصورت وجود به‌روزرسانی امنیتی، باید نصب Drupal را در اسرع وقت ارتقا دهید تا مطمئن شوید سایتتان ایمن باقی می‌ماند.

ارتقا دادن هسته Drupal

روش زیر نحوه به‌روزرسانی نصب «ابر خصوصی» Drupal 7.x.y به نسخه فرعی دیگر (برای نمونه، Drupal 7.54 به 7.59) را شرح می‌دهد.

لطفاً به موارد زیر توجه کنید:

  • این روش فقط نصب Drupal شما را به‌روز می‌کند. این کار نرم‌افزار Apigee را که به‌عنوان بخشی از درگاه ارائه می‌شود به‌روزرسانی نمی‌کند. برای کسب اطلاعات درباره ارتقای نرم‌افزار درگاه Apigee، ارتقای درگاه را ببینید.

    اگر درطول ارتقا «ابر خصوصی» (برای مثال، از 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 و واحدهای همیاری Drupal

وقتی Drupal را بااستفاده از دستورالعمل‌های بالا در این بخش ارتقا می‌دهید، واحدهای مورداستفاده Drupal مثل contrib و PHP نیز ارتقا می‌یابند. بااین‌حال، باید بین نسخه‌های «ابر خصوصی» با جدیدترین واحدهای Drupal همگام باشید.

توجه داشته باشید که اگر واحد در /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 تماس بگیرید و پیام‌های خطایی را که درطول به‌روزرسانی گزارش شده است ارائه دهید.