שדרוג גרסת ה-Drupal של התקנה בענן פרטי

Edge for Private Cloud גרסה 4.17.09

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

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

שימו לב:

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

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

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

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