שדרוג Drupal

בהתקנה של פורטל שירותי הפיתוח של Apigee (או פשוט הפורטל) ב-Edge for Private Cloud, יכול להיות שתקבלו הודעה שגרסה חדשה של 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. אפשר גם לעיין במאמר Updating Drupal Using 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 core. אפשר להריץ את drush pm-updatestatus כדי להציג רשימה של עדכונים קטנים זמינים לפרויקטים של Drupal core ו-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 contrib

כשמשדרגים את 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 וציינו את הודעות השגיאה שדווחו במהלך העדכון.