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

Edge for Private Cloud v4.18.01

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

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

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