שדרוג Drupal

Edge for Private Cloud גרסה 4.18.05

בהתקנה של Edge for Private Cloud בפורטל של Apigee Developer Services (או פשוט הפורטל), יכול להיות שתקבלו התראה על כך שגרסה חדשה של Drupal זמינה. גרסה חדשה יכולה להיות גרסה של תכונה חדשה ב-Drupal, תיקון, עדכון אבטחה או סוג אחר של עדכון ל-Drupal. במקרה של עדכון אבטחה, מומלץ לשדרג את התקנת Drupal בהקדם האפשרי כדי לוודא שהאתר יישאר מאובטח.

במסגרת התהליך שבהמשך מוסבר איך לעדכן התקנה בענן פרטי של Drupal 7.x.y לגרסה משנית אחרת (לדוגמה, Drupal בגרסה 7.54 עד 7.56).

שימו לב:

• התהליך הזה מעדכן רק את ההתקנה של Drupal. הוא לא מעדכן את תוכנת Apigee שסופקה כחלק מהפורטל. מידע על שדרוג התוכנה של פורטל Apigee זמין במאמר שדרוג הפורטל.

• צריך להריץ את פקודות Drush מספריית הבסיס (root) של אתר הפורטל. כברירת מחדל, הפורטל מותקן במיקום:
  • /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 Shell) בשורת הפקודה כדי לעדכן את גרסת Drupal. אפשר גם לעיין במאמר עדכון Drupal באמצעות Drush במסמכי העזרה של Drupal.

כדי לעדכן את ההתקנה של 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-7.56

   לחלופין, אפשר להריץ את drush pm-update drupal כדי לעדכן לגרסת הליבה האחרונה של Drupal. אפשר להריץ את הפקודה 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

מה קורה אם נתקלת בבעיה במהלך העדכון?

משחזרים את האתר למצבו הקודם באמצעות קובצי הגיבוי שיצרתם. פונים לנציג התמיכה של Apigee ומספקים את הודעות השגיאה שדווחו במהלך העדכון.