שדרוג הפורטל של השירותים למפתחים

פורטל השירותים למפתחים גרסה 4.17.01

בתהליך הזה נסביר איך לשדרג התקנה מקומית של Apigee Developer Channel Services.

ספריית ברירת המחדל להתקנה

תהליך השדרוג מניח שהפורטל למפתחים הותקן ב-/var/www/html. אם לא התקנתם את הפורטל בספריית ברירת המחדל, עליכם לשנות את הנתיבים בהליך הבא כדי להשתמש בספריית ההתקנה.

אם ספריית ההתקנה לא מוכרת לך, אפשר לקבוע אותה כפי שמתואר בפקודות Drush שנמצאות בשימוש נפוץ.

גרסאות שדרוג נתמכות

תהליך השדרוג הזה נתמך בגרסאות הבאות של הפורטל:

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x

כדי לבדוק מהי גרסת הפורטל, יש לפתוח את כתובת ה-URL הבאה בדפדפן:

http://yourportal.com/buildInfo

לפני ההתקנה

בהתקנות קיימות, אם שינית קוד בליבה של Drupal או במודולים שאינם מותאמים אישית, השינויים שביצעת יוחלפו. כולל, בין היתר, כל שינוי שביצעת ב-.htaccess. צריך להניח שכל פריט שנמצא מחוץ לספרייה /sites הוא בבעלות Drupal. החריגה לכלל הזה היא robots.txt. אם הקובץ קיים בשורש האינטרנט, הוא יישמר בשבילכם.

לפני שממשיכים בהתקנה, צריך לגבות את כל ספריית השורש באינטרנט של Drupal. מיקום ההתקנה המוגדר כברירת מחדל הוא /var/www/html, אך ייתכן ששינית אותו בזמן ההתקנה. לאחר ביצוע שלבי ההתקנה המתוארים בהמשך, ניתן לשחזר את ההתאמות האישיות מהגיבוי.

שדרוג של שירותי הערוץ למפתחים של Apigee לגרסה חדשה

  1. גיבוי של מופע ה-Drupal MySQL.
    מידע נוסף זמין בכתובת http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. אפשרות 1: שימוש ב-Drush

      פקודת Drush sql-dump יוצרת עותק של מסד הנתונים. מספריית ה-Drupal שלך, בכתובת /var/www/html, מריצים כברירת מחדל את הפקודה:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      לקבלת מידע נוסף, אפשר להשתמש ב-drush help sql-dump.
    2. אפשרות 2: שימוש ב-MySQLdump
      משתמשים בפקודה mysqldump כדי ליצור עותק של מסד הנתונים:
      mysqldump -u USERNAME -p'סיסמה' DATABASENAME > /path/to/backup_dir/database-backup.sql

      לא צריך להיות רווח בין האפשרות -p בין הפרמטר -p אם הסיסמה מכילה תווים מיוחדים, צריך להוסיף לה מירכאות בודדות.

      מגדירים את USERNAME ואת DATABASENAME כשהתקנתם את הפורטל. כברירת מחדל, שניהם פיתוחים.
  2. יוצרים גיבוי של כל ספריית השורש באינטרנט של Drupal. מיקום ההתקנה המוגדר כברירת מחדל הוא /var/www/html, אך ייתכן ששינית אותו בזמן ההתקנה.
  3. מורידים את הקובץ DeveloperServices_x.y.z.tar של השירותים למפתחים ב-ftp.apigee.com, כאשר x.y.z תואם למספר הגרסה של הפורטל. כשהבקשה מופיעה, צריך להזין את פרטי הכניסה שקיבלת מ-Apigee.

    אפשר להוריד קובץ מהקישור שנשלח אליך על ידי Apigee בדפדפן או על ידי העתקה שלו והוספה שלו לפקודת ה-cURL הבאה:
    > curl -kOL <paste link כאן>

    הערה: אם הפורטל נמצא בשרת ללא חיבור אינטרנט חיצוני, יש לבצע את השלב הזה בשרת עם גישה.

    נכנסים לכתובת http://community.apigee.com/content/apigee-customer-support ובוחרים באפשרות Login to your Support Portal כדי לבקש שדרוג של קובץ ה- .tar של שירותי הערוצים למפתחים. אם אין לך חשבון בפורטל התמיכה, עליך לבחור באפשרות Login to your Support Portal (התחברות לפורטל התמיכה שלך), ואז בדף הכניסה ולבחור באפשרות No a Hrush? אפשר להעלות כרטיס תמיכה כאן.
  4. כדי לשדרג בשרת עם חיבור לאינטרנט:
    1. מחלצים את קובץ שדרוג הפורטל:
      > tar -xvf <tar file>

      חילוץ הפקודות הזה יוצר ספרייה חדשה בשם DeveloperServices-4.x.y.z.
    2. עוברים לספרייה DeveloperServices-4.x.y.z.
    3. מורידים את הגרסה האחרונה של Drupal באמצעות הפקודה הבאה:
      > drush dl drupal

      הפקודה הזו יוצרת ספרייה בשם drupal-x.y, שבה x.y תואם לגרסה הנוכחית של Drupal.
    4. מריצים את הסקריפט networked-update.sh:
      > ./networked-update.sh

      בהתאם להרשאות הקובץ, יכול להיות שתצטרכו להשתמש ב-sudo כדי להריץ את הפקודה הזו, או להריץ אותה כאדמינים.
    5. כדי לקבל התראות על עדכונים של Drupal, צריך לוודא שהמודול של Drupal Update Manager מופעל. בתפריט Drupal, בוחרים באפשרות Modules וגוללים למטה אל המודול Update manager. אם היא לא מופעלת, מפעילים אותה.

      לאחר ההפעלה, אפשר לראות את העדכונים הזמינים דרך פריט התפריט דוחות > עדכונים זמינים.

      בתפריט דוחות > עדכונים זמינים > הגדרות אפשר להגדיר שהמודול ישלח לך אימייל כשיהיו עדכונים זמינים, וכדי להגדיר את התדירות שבה כדאי לבדוק אם יש עדכונים.
  5. לשדרוג בשרת שאין בו חיבור לאינטרנט:
    1. בשרת שממנו הורדתם את הקובץ DeveloperServices_x.y.z.tar של שירותי הערוץ למפתחים, מחלצים את קובץ השדרוג של הפורטל:
      > tar -xvf <tar file>

      חילוץ הפקודה הזו יוצר ספרייה חדשה בשם DeveloperServices-4.x.y.z.
    2. עוברים לספרייה DeveloperServices-4.x.y.z.
    3. מריצים את הסקריפט non-networked-update.sh:
      > ./non-networked-update.sh

      בהתאם להרשאות הקובץ, יכול להיות שתצטרכו להשתמש ב-sudo כדי להריץ את הפקודה הזו, או להריץ אותו כאדמינים.

      הפקודה הזו מורידה את כל קובצי העדכון הנחוצים ואוספת אותם לקובץ אחד בשם devportal-update.tgz וכותבת את הקובץ במיקום לבחירתכם.
    4. מעתיקים את devportal-update.tgz לשרת היעד, שהוא זה שמפעיל את הפורטל.
      הערה: לא מעתיקים את קובץ ה-devportal-update.tgz לבסיס האינטרנט של שרת היעד.
    5. פותחים את הקובץ devportal-update.tgz לספרייה הנוכחית:
      > tar -xzf /path/to/devportal-update.tgz
    6. עוברים לספרייה developer-update.
    7. כדי להתקין את העדכון, מריצים את הפקודה הבאה:
      > ./install-update.sh
    8. עונים להנחיות.

השדרוג הושלם.