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

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

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

קביעת תהליך העדכון הנכון

ההליך שבו אתם משתמשים לעדכון הפורטל מבוסס על ההתקנה הנוכחית שלכם:

קביעת סוג ההתקנה הנוכחי

אם לא בטוחים לגבי סוג ההתקנה הנוכחי, משתמשים בפקודה הבאה כדי לבדוק מה סוג ההתקנה:

  • ls /opt
    אם אתם משתמשים ב-Nginx/Postgres, יופיעו הספריות הבאות: /opt/apigee ו-/opt/nginx.

    אם אתם משתמשים ב-Apache/MySQL, או ב-Apache/MariaDB, הספריות האלה לא נמצאות.
  • /opt/apigee/apigee-service/bin/apigee-all status
    אם משתמשים ב-Nginx/Postgres, יוצג הפלט הבא:

    + apigee-service apigee-drupal-devportal status
    OK: lbapigee-drupal-devportal is up and runninglbgee-drupal-devportal is up and runninglbgee-drupal-devportal is up and runninglbgee-grapige status



  • apachectl -S
    אם משתמשים ב-Apache/MySQL או ב-Apache/MariaDB, הפקודה הזו אמורה להחזיר את ספריית הבסיס באינטרנט של הפורטל, באופן הבא:

    *:80 192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)

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

תהליך השדרוג מבוסס על ההנחה שהפורטל למפתחים הותקן ב:

  • /opt/apigee/apigee-drupal (Nginx)
  • /var/www/html (Apache)

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

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

ספריית ברירת מחדל חדשה להתקנה לאחר עדכון של Nginx/Postgres מהתקנה חדשה של 4.17.01

אחרי עדכון התקנה חדשה של 4.17.01 שמשתמשת ב-Nginx/Postgres, ספריית השורש השתנתה מ:

/opt/apigee/apigee-drupal

 ב-:

/opt/apigee/apigee-drupal/wwwroot

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

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

  • 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
  • OPDK-17-01.x

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

http://yourportal.com/buildInfo

לפני העדכון

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

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

שדרוג פורטל באמצעות קובץ .tar

  1. מגבים את המכונה של Drupal MySQL/MariaDB.
    מידע נוסף זמין בכתובת 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 כאן>

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

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

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

שדרוג פורטל באמצעות RPM

כדי לעדכן את ה-RPM של הפורטל בצומת, יש לבצע את התהליך הבא:

  1. משנים לספריית Drupal, /opt/apigee/apigee-drupal כברירת מחדל:
    > cd /opt/apigee/apigee-drupal
  2. מגבים את המופע של מסד הנתונים של Drupal. הפקודה pg_dump יוצרת עותק של מסד הנתונים:

    pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp:

    • dbname מציין את השם של מסד הנתונים כפי שצוין במאפיין PG_NAME בקובץ התצורה של ההתקנה של הפורטל.
    • host מציין את כתובת ה-IP של צומת הפורטל.
    • השדה username מציין את שם המשתמש ב-Postgres שבו משתמש הפורטל כדי לגשת לבסיס הנתונים, כפי שצוין בנכס DRUPAL_PG_USER בקובץ התצורה של התקנת הפורטל.
    • תוצג לכם בקשה להזין את סיסמת המשתמש של Postgres כפי שהוגדרה במאפיין DRUPAL_PG_PASS בקובץ התצורה של התקנת הפורטל.

    אם בשלב מאוחר יותר תצטרכו לבצע שחזור מהגיבוי, משתמשים בפקודה:
    pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
  3. יוצרים גיבוי של כל ספריית השורש באינטרנט של Drupal. מיקום ההתקנה המוגדר כברירת מחדל הוא /opt/apigee/apigee-drupal, אבל יכול להיות ששיניתם אותו.

    אם לא ברור איפה הספרייה הזו נמצאת, אפשר להיעזר בפקודה drush status או בפקודה Configuration > Media > File (הגדרה > מדיה > קובץ) בתפריט של Drupal כדי לקבוע את המיקום של מערכת הקבצים הציבורית והנתיב של מערכת הקבצים הפרטית (לשלב הבא).
  4. צרו גיבוי של הקבצים בכתובת /opt/apigee/data/apigee-drupal-devportal/private.
  5. משביתים את SELinux כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
  6. כדי לשדרג בשרת עם חיבור לאינטרנט:
    1. מורידים את הקובץ bootstrap_4.17.05.sh מגרסת Edge 4.17.05 לכתובת bootstrap_4.17.05.sh:
      > curl https://software.apigee.com/shoestrap_4.17.05.sh -o /tmpsh/shoestrap_4.17
    2. מתקינים את הכלי ואת יחסי התלות של apigee-service 4.17.05:
      > sudo bash /tmp/shoestrap_4.17.05.sh apigeeuser=uName apigeepassword=uName

      כאשר uName הוא שם המשתמש והסיסמה שקיבלת. אם לא תשמיטו את pWord, תתבקשו להזין אותו.

      כברירת מחדל, מנהל ההתקנה בודק שמותקנת במכשיר Java 1.8. אפשר להשתמש באפשרות C כדי להמשיך בלי להתקין את Java.
  7. לשדרוג בשרת שאין בו חיבור לאינטרנט:
    1. יוצרים מאגר מקומי בגרסה 4.17.05 כמו שמתואר ב'יצירת מאגר Apigee מקומי' במאמר התקנת כלי השירות Edge apigee-setup.
      הערה: אם כבר יש לכם מאגר 4.17.01, אפשר להוסיף אליו את המאגר 4.17.05 כמו שמתואר ב'עדכון מאגר Apigee מקומי' בהתקנת כלי השירות Edge apigee-setup.
    2. כדי להתקין את שירות ה-API מקובץ .tar:
      1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
        > /opt/apigee/apigee-service/bin/apigee-miror apigee package
      2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
      3. בצומת החדש, מבטלים את היררכיית הקובץ /tmp:
        > tar -xzf apigee-4.17.05.tar.gz

        פקודה זו יוצרת ספרייה חדשה שנקראת repos, בספרייה שמכילה את קובץ ה- .tar. לדוגמה: /tmp/repos.
      4. מתקינים את כלי העזר apigee-service ואת יחסי התלות של Edge מ-/tmp/repos:
        > sudo bash /tmp/repos/shoestrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        שימו לב שכללתם את הנתיב למאגר בפקודה הזו.
    3. כדי להתקין את השירות API באמצעות שרת האינטרנט של Nginx:
      1. מגדירים את שרת האינטרנט של Nginx כפי שמתואר במאמר 'התקנה מהמאגר באמצעות שרת האינטרנט של Nginx' במאמר התקנת כלי השירות Edge apigee-setup.
      2. בנקודת הצומת המרוחקת, מורידים את הקובץ Edge bootstrap_4.17.05.sh מהקובץ bootstrap_4.17.05.sh:
        > /usr/bin/curl http://uName:pWord@remoteRepo:3939/shoestrap0.Repo:3939/shoestrap_4.17.

      3. בצומת המרוחק, מתקינים את כלי השירות apigee-service ויחסי התלות של Edge:
        > sudo bash /tmp/shoestrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=uName apigeepassword=pWord=API כאשר הוא

  8. משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. מריצים את תוכנית השירות לעדכון בצומת כדי לעדכן את מסד הנתונים Postgres:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    כאשר configFile הוא קובץ התצורה שבו השתמשתם כדי להתקין את מסד הנתונים Postgres. הדרישה היחידה בקובץ התצורה היא שקובץ התצורה צריך להיות נגיש למשתמש ה-"apigee" או קריא לו.
  10. הפעלה של Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. מריצים את תוכנית השירות לעדכון בצומת כדי לעדכן את הפורטל:
    > /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    כאשר configFile הוא קובץ התצורה שבו השתמשתם כדי להתקין את הפורטל. הדרישה היחידה בקובץ התצורה היא שקובץ התצורה חייב להיות נגיש או קריא למשתמש ה-API.

שימו לב שספריית הבסיס שאחרי העדכון היא עכשיו:

/opt/apigee/apigee-drupal/wwwroot

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