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

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

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

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

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

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

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

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

• ls /opt
  אם אתם משתמשים ב-Nginx/Postgres, יופיעו הספריות הבאות: /opt/apigee ו-/opt/nginx.
  
  אם אתם משתמשים ב-Apache/MySQL או Apache/MariaDB, הספריות האלה לא צריכות להיות כיום.
• /opt/apigee/apigee-service/bin/apigee-all סטטוס
  אם אתם משתמשים ב-Nginx/Postgres, יתקבל הפלט הבא:
  
  + שירות apigee סטטוס apigee-drupal-devportal
  תקין: apigee-drupal-devportal פועל
  + סטטוס apigee-service apigee-lb
  apigee-service: apigee-lb: אישור
  + סטטוס apigee-postgresql לשירות
  apigee-service: apigee-postgresql: OK
• 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 Core או בקוד שלא מותאם אישית מודולים, השינויים שלך יוחלפו. זה כולל, בין היתר, שינויים כלשהם אולי הגדרתם את הגישה ל-.htaccess. צריך להניח שכל תוכן מחוץ לספרייה /sites נמצא בבעלות Drupal. יוצא הדופן לכלל הזה הוא robots.txt; אם הקובץ הזה קיים באינטרנט הרמה הבסיסית (root), היא תישמר עבורך.

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

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

שדרוג פורטל באמצעות הכנסה לאלף צפיות

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

1. עוברים לספריית Drupal, /opt/apigee/apigee-drupal עד ברירת מחדל:
   &gt; 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 או הגדרה > מדיה > קובץ בתפריט 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 אל /tmp/shoestrap_4.17.05.sh:
      > תלתל https://software.apigee.com/shoestrap_4.17.05.sh -o /tmp/shoestrap_4.17.05.sh
   2. מתקינים את כלי השירות apigee-service 4.17.05 ו- של יחסי התלות:
      > sudo bash /tmp/shoestrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
      
      כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם ב-Apigee. אם משמיטים את המילה pWord, תתבקשו להזין אותה.
      
      כברירת מחדל, מנהל ההתקנה בודק אם התקנתם את Java 1.8. אפשר להשתמש "ג" כדי להמשיך בלי להתקין Java.
7. כדי לשדרג בשרת ללא חיבור לאינטרנט:
   1. יוצרים מאגר 4.17.05 מקומי כפי שמתואר ב"יצירת מאגר Apigee מקומי" על התקנת apigee-setup של Google.
      הערה: אם כבר יש לכם מאגר 4.17.01 קיים, תוכלו להוסיף את 4.17.05 מאגר שלו כפי שמתואר ב"עדכון מאגר Apigee מקומי" בהתקנת כלי ההגדרה של Edge apigee-setup.
   2. כדי להתקין את apigee-service מקובץ .tar:
      1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את הקובץ המקומי repo לקובץ .tar יחיד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
         > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, העתקה לספרייה /tmp בצומת החדש.
      3. בצומת החדש, מסירים את הקובץ לספריית /tmp:
         &gt; 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
         
         שימו לב שהפקודה הזו כוללת את הנתיב לספריית ה-repos.
   3. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
      1. מגדירים את שרת האינטרנט Nginx כפי שמתואר בקטע 'התקנה מהמאגר באמצעות שרת האינטרנט Nginx בדף Install the Edge הכלי apigee-setup.
      2. בצומת המרוחק, מורידים את קובץ bootstrap_4.17.05.sh של Edge אל /tmp/shoestrap_4.17.05.sh:
         > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/shoestrap_4.17.05.sh
         
         כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה עבור המאגר, ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של הצומת של המאגר.
      3. בצומת המרוחק, מתקינים את כלי השירות apigee-service של Edge ואז של יחסי התלות:
         > sudo bash /tmp/shoestrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
         
         כאשר uName:pWord הם שם המשתמש והסיסמה במאגר.
8. להשתמש ב-apigee-service כדי לעדכן את apigee-setup תוכנית שירות:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
9. מריצים את כלי העדכון בצומת כדי לעדכן את מסד הנתונים של Postgres:
   &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   
   configFile הוא קובץ התצורה שבו השתמשתם כדי להתקין. במסד הנתונים של Postgres. הדרישה היחידה בקובץ התצורה היא שהתצורה הקובץ חייב להיות נגיש או קריא באמצעות ה-apigee משתמש.
10. הפעלת Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
11. מריצים את כלי העדכון בצומת כדי לעדכן את הפורטל:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
    
    configFile הוא קובץ התצורה שבו השתמשתם כדי להתקין. להיכנס לפורטל. הדרישה היחידה בקובץ התצורה היא שקובץ התצורה חייב להיות נגיש או קריא באמצעות ה-'apigee' משתמש.

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

/opt/apigee/apigee-drupal/wwwroot

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