שדרוג Drupal

Edge for Private Cloud גרסה 4.19.01

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

שדרוג הליבה של Drupal

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

חשוב לשים לב לנושאים האלה:

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

  במהלך שדרוג לענן פרטי (למשל מ-4.18.05 מ-4.18.05 ל-4.19.01), אם תוכנת העדכון של Apigee למעשה משדרגת לאחור את הגרסה של Drupal, יכול להיות שתצטרכו להפעיל מחדש את כלי השדרוג של Drupal. מידע נוסף זמין במאמר הפעלה מחדש של שדרוג ה-Drupal.

• צריך להריץ את פקודות Drush (Drupal Shell) מספריית השורש של אתר הפורטל. כברירת מחדל, הפורטל מותקן במקומות הבאים:
  • /opt/apigee/apigee-drupal/wwwroot (Nginx)
  • /var/www/html (אפאצ'י)
  התהליך שבהמשך מניח התקנה של שרת 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 ולתרום לפרויקטים.

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, בין הגרסאות של Private Cloud.

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