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

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

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

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

תהליך השדרוג מניח שפורטל המפתחים הותקן בכתובת /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 Core או בקוד שלא מותאם אישית מודולים, השינויים שלך יוחלפו. זה כולל, בין היתר, שינויים כלשהם אולי הגדרתם את הגישה ל-.htaccess. צריך להניח שכל תוכן מחוץ לספרייה /sites נמצא בבעלות Drupal. יוצא הדופן לכלל הזה הוא robots.txt; אם הקובץ הזה קיים באינטרנט הרמה הבסיסית (root), היא תישמר עבורך.

לפני שממשיכים בהתקנה, צריך ליצור גיבוי של כל תיקיית השורש של 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 שם משתמש – p'סיסמה' DATABASENAME > /path/to/backup_dir/database-backup.sql

      אסור שיהיה רווח בין האפשרות -p לסיסמה. רווק או רווקה דרושות מירכאות מסביב לסיסמה אם הסיסמה מכילה תווים מיוחדים.

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

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

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

    עוברים אל http://community.apigee.com/content/apigee-customer-support ובוחרים באפשרות התחברות לפורטל התמיכה כדי לבקש את ערוץ המפתחים שדרוג שירותים של קובץ tar. אם אין לכם חשבון בפורטל התמיכה, תוכלו לבחור מתחברים לפורטל התמיכה שלכם, ובדף הכניסה לחשבון, בוחרים באפשרות להזדרז? כאן אפשר לפתוח כרטיס תמיכה.
  4. כדי לשדרג בשרת עם חיבור לאינטרנט:
    1. מחלצים את קובץ השדרוג של הפורטל:
      &gt; tar -xvf <tar file&gt;

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

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

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

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

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

      חֶלֶץ הפקודה הזו יוצר ספרייה חדשה בשם 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. כדי להתקין את העדכון, מריצים את הפקודה הבאה:
      &gt; ./install-update.sh
    8. עונים להנחיות.

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