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

Edge for Private Cloud v4.18.01

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

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

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

• אם ההתקנה שלכם משתמשת ב-Nginx/Postgres, השתמשו בקטע שדרוג פורטל באמצעות RPM שבהמשך.
• אם ההתקנה שלכם משתמשת ב-Apache/MySQL או ב-Apache/MariaDB, עיינו במאמר המרת פורטל מבוסס-tar לפורטל מבוסס-RPM.

איך בודקים את סוג ההתקנה הנוכחי

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

• 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: apigee-drupal-devportal is up and running
  + apigee-service apigee-lb status
  apigee-service: apigee-lb: OK
  + apigee-service apigee-postgresql status
  apigee-service: apigee-postgresql: OK

• apachectl -S

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

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

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

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

• גרסה 4.17.05 ואילך: /opt/apigee/apigee-drupal/wwwroot
• לפני גרסה 4.17.05: /opt/apigee/apigee-drupal (Nginx) או /var/www/html (Apache)

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

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

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

• OPDK-17-01.x
• OPDK-17-05.x
• OPDK-17-09.x

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

http://yourportal.com/buildInfo

לפני שמעדכנים

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

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

שדרוג פורטל באמצעות 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. מגדירים את Drupal למצב תחזוקה:
   1. בתפריט של Drupal, לוחצים על Configuration (הגדרה).
   2. בדף Configuration, בוחרים באפשרות Maintenance mode בקטע Development.
   3. מסמנים את התיבה העברת האתר למצב תחזוקה.
   4. מזינים הודעה שהמשתמשים יראו במהלך התחזוקה.
   5. לוחצים על שמירת ההגדרה.
6. משביתים את SELinux כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
7. עוברים לספרייה /opt:

   > cd /opt

8. לשדרוג בשרת עם חיבור לאינטרנט:
   1. מורידים את הקובץ Edge 4.18.01 bootstrap_4.18.01.sh אל /tmp/bootstrap_4.18.01.sh:

      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

   2. מתקינים את כלי השירות apigee-service של Edge 4.18.01 ואת יחסי התלות:

      sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

      כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם מ-Apigee. אם לא תציינו את pWord, תתבקשו להזין אותו.

      כברירת מחדל, מנהל ההתקנה בודק אם מותקנת גרסה 1.8 של Java. אפשר להשתמש באפשרות "C" כדי להמשיך בלי להתקין את Java.

9. לשדרוג בשרת ללא חיבור לאינטרנט:
   1. יוצרים מאגר מקומי בגרסה 4.18.01, כמו שמתואר בקטע "יצירת מאגר Apigee מקומי" במאמר התקנת כלי השירות apigee-setup של Edge.
   2. כדי להתקין את apigee-service מקובץ ‎ .tar:
      1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי לקובץ ‎ .tar יחיד בשם /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:

          /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. מעתיקים את קובץ ה-‎ .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
      3. בצומת החדש, מבטלים את הדחיסה של הקובץ לספרייה ‎ /tmp:

         tar -xzf apigee-4.18.01.tar.gz

         הפקודה הזו יוצרת ספרייה חדשה בשם repos, בספרייה שמכילה את קובץ ה-‎ .tar. לדוגמה, ‎ /tmp/repos.

      4. מתקינים את כלי השירות Edge apigee-service ואת יחסי התלות מ-/tmp/repos:

         sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

         שימו לב שהפקודה הזו כוללת את הנתיב לספריית המאגרים.

   3. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
      1. מגדירים את שרת האינטרנט Nginx כמו שמתואר בקטע "התקנה מהמאגר באמצעות שרת האינטרנט Nginx" במאמר התקנת כלי השירות apigee-setup של Edge.
      2. בצומת המרוחק, מורידים את קובץ ה-Edge bootstrap_4.18.01.sh אל /tmp/bootstrap_4.18.01.sh:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh
           -o /tmp/bootstrap_4.18.01.sh

         כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה למאגר, ו-remoteRepo היא כתובת ה-IP או שם ה-DNS של צומת המאגר.

      3. בצומת המרוחק, מתקינים את כלי השירות של Edge apigee-service ואת יחסי התלות:

         sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939
             apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.

10. משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup:

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

11. מריצים את כלי העדכון בצומת של PostgreSQL:

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    configFile הוא קובץ התצורה שבו השתמשתם כדי להתקין את מסד הנתונים של Postgres. הדרישה היחידה לגבי קובץ התצורה היא שמשתמש "apigee" יוכל לגשת אליו או לקרוא אותו.

12. מעדכנים את מסד הנתונים של Postgres:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

13. מריצים את כלי העדכון בצומת כדי לעדכן את הפורטל:

    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

14. מריצים את הסקריפט update.php של Drupal על ידי פתיחת כתובת ה-URL הבאה בחלון דפדפן:

    http://portalIP_DNS:8079/update.php

15. משביתים את Drupal למצב תחזוקה:
    1. בתפריט של Drupal, לוחצים על Configuration (הגדרה).
    2. בדף Configuration, בוחרים באפשרות Maintenance mode בקטע Development.
    3. מבטלים את הסימון של התיבה Put site into maintenance mode (העברת האתר למצב תחזוקה).
    4. לוחצים על שמירת ההגדרה.

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

/opt/apigee/apigee-drupal/wwwroot

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