ارتقا دادن Drupal

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

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

روال زیر نحوه به‌روزرسانی نصب Drupal 7.x.y در Private Cloud به نسخه جزئی دیگر (برای مثال، Drupal 7.54 به 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 و پروژه‌های contrib را ببینید.

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