סקירה כללית של התקנת קצה

התקנה אופיינית של Edge מורכבת מרכיבי Edge שמופצים בין כמה צמתים. אחרי שמתקינים את Edge בצומת, צריך להתקין ולהגדיר רכיב אחד או יותר של Edge בצומת.

תהליך ההתקנה

התקנת Edge בצומת היא תהליך רב-שלבי:

  1. משביתים את SELinux בצומת או מגדירים אותו למצב מתיר. למידע נוסף, ראו התקנת כלי ההגדרה של Edge apigee-setup.
  2. מחליטים אם להפעיל אימות של Cassandra.
  3. מחליטים אם רוצים להגדיר רפליקציית המתנה ראשית ל-Postgres.
  4. בוחרים את ההגדרות האישיות של Edge מרשימת הטופולוגיות המומלצות. לדוגמה, אפשר להתקין את Edge בצומת יחיד לצורך בדיקה, או ב-13 צמתים עבור סביבת ייצור. מידע נוסף זמין במאמר טופולוגיות של התקנה.
  5. מתקינים את כלי השירות apigee-setup של Edge בכל צומת בטופולוגיה שבחרתם:
    • מורידים את קובץ Edge bootstrap_4.52.02.sh אל /tmp/bootstrap_4.52.02.sh.
    • מתקינים את כלי השירות apigee-service ואת יחסי התלות של Edge.
    • מתקינים את כלי השירות apigee-setup ואת יחסי התלות של Edge.

      למידע נוסף, ראו התקנת כלי ההגדרה של Edge apigee-setup.

  6. בעזרת הכלי apigee-setup תוכלו להתקין רכיב אחד או יותר של Edge בכל צומת, בהתאם לטופולוגיה שבחרתם.

    למידע נוסף, ראו התקנת רכיבי Edge בצומת.

  7. בצומת של שרת הניהול, משתמשים בכלי apigee-setup כדי להתקין את apigee-provision, את כלי העזר שבהם משתמשים כדי ליצור ולנהל ארגונים של Edge.

    מידע נוסף זמין במאמר הצטרפות לארגון.

  8. בסיום ההתקנה, מפעילים מחדש את הרכיב של ממשק המשתמש הקלאסי בכל צומת, כפי שמוצג בדוגמה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

  9. (מומלץ) אחרי השלמת ההתקנה הראשונית, מומלץ להתקין את ממשק המשתמש החדש של Edge (ששם הרכיב שלו הוא edge-management-ui), שהוא ממשק משתמש משופר למפתחים ולאדמינים של Apigee Edge לענן פרטי.

    למידע נוסף אפשר לקרוא את המאמר התקנת ממשק המשתמש החדש של Edge.

בסיום ההתקנה, מומלץ לעיין ברשימת הפעולות הנפוצות לאחר ההתקנה.

מי יכול לבצע את ההתקנה

קובצי ההפצה של Apigee Edge מותקנים כקבוצה של הכנסות לאלף חשיפות ויחסי תלות. כדי להתקין, להסיר ולעדכן הכנסות לאלף חשיפות של Edge, הפקודות חייבות להתבצע על ידי משתמש ברמה הבסיסית (root) או על ידי משתמש שיש לו גישת sudo מלאה. לגישת sudo מלאה, המשתמש יכול לבצע את אותן פעולות כמו הרמה הבסיסית (sudo).

כל משתמש שרוצה להריץ את הפקודות או הסקריפטים הבאים צריך להיות ברמה הבסיסית (root) או להיות משתמש עם גישת sudo מלאה:

  • הכלי apigee-service:
    • פקודות apigee-service: install, uninstall, update.
    • פקודות apigee-all: install, uninstall, update.
  • הסקריפט setup.sh להתקנת רכיבי Edge (אלא אם כבר השתמשתם "apigee-service install" כדי להתקין את ה-RPM הנדרשות. ואז גישת Root או גישת sudo מלאה אם לא נדרשת).
  • הסקריפט update.sh לעדכון רכיבי Edge

בנוסף, מנהל ההתקנה של Edge יוצר משתמש חדש במערכת בשם 'apigee'. פקודות רבות של Edge מפעילים sudo כדי להריץ אותו כמשתמש 'apigee'.

כל משתמש שרוצה להריץ את כל הפקודות האחרות בנוסף לאלו שמוצגות למעלה צריך להיות משתמש עם גישת sudo מלאה למשתמש ה-apigee. הפקודות האלה כוללות:

  • פקודות של הכלי apigee-service, כולל:
    • פקודות apigee-service, כמו start, stop, restart, configure.
    • פקודות apigee-all, כמו start, stop, restart, configure.

יצירת משתמש עם גישת sudo מלאה למשתמש 'apigee'

כדי להגדיר למשתמש גישת sudo מלאה למשתמש ה-apigee, משתמשים בפקודה visudo כדי לערוך את קובץ ה-sudoers ולהוסיף אותו:

installUser        ALL=(apigee)      NOPASSWD: ALL

installUser הוא שם המשתמש של האדם שעובד עם Edge.

קביעת הרשאות לקובצי תצורה

כל הקבצים או המשאבים שבהם נעשה שימוש בפקודות Edge חייבים להיות נגישים למשתמש ה-apigee. זה כולל את קובץ הרישיון ל-Edge ואת כל קובצי התצורה.

כשיוצרים קובץ תצורה, אפשר לשנות את הבעלים שלו ל-'apigee:apigee' כדי לוודא שהוא נגיש לפקודות Edge:

  1. יוצרים את הקובץ בכלי עריכה בתור כל משתמש אחר.
  2. chown הבעלים של הקובץ ל-'apigee:apigee'. אם שיניתם את המשתמש שמפעיל את שירות Edge ממשתמש עם ה-apigee, צריך לשייך את הקובץ למשתמש שמפעיל את שירות Edge.

הפרדת משימות התקנה של Edge בין משתמש ברמה הבסיסית (root) לבין משתמש שאינו Root

הדרך הקלה ביותר היא לבצע את כל תהליך ההתקנה של Edge ברמה הבסיסית (root) או על ידי משתמש עם גישת sudo מלאה, אבל זה לא תמיד אפשרי. במקום זאת, אפשר להפריד את התהליך למשימות שבוצעו על ידי הרמה הבסיסית (root) ולמשימות שמשתמש עם גישת sudo מלאה למשתמש ה-apigee.

  1. המשימות שבוצעו לפי הרמה הבסיסית (root):
    1. מורידים ומפעילים את הקובץ bootstrap_4.52.02.sh: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      שלב זה מתקין את כלי השירות apigee-service ויוצר את המשתמש 'apigee'.

    2. מגדירים שלמשתמש תהיה גישת sudo מלאה למשתמש ה-apigee כפי שמתואר במאמר יצירת משתמש עם גישת sudo מלאה למשתמש ב-apigee.
    3. מתקינים את כלי השירות apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. משתמשים בכלי השירות apigee-setup כדי להתקין הכנסות לאלף חשיפות (RPM) של Edge בצומת: 
      /opt/apigee/apigee-service/bin/apigee-service compName install

      ההכנסות לאלף חשיפות ב-Edge שתתקינו בצומת תלויות בטופולוגיה שלכם. רשימת הרכיבים הזמינים כוללת: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

  2. אחרי שמשתמש ה-Root יתקין את ה-RPM של Edge בצומת, המשתמש עם גישת sudo מלאה למשתמש ה-apigee משלים את תהליך ההגדרה:
    1. בעזרת הכלי setup.sh תוכלו להשלים את ההגדרה של רכיבי Edge בצומת. צורת הפקודה תלויה ברכיבים שהתקנתם בצומת. רשימה מלאה מופיעה במאמר התקנת רכיבי Edge בצומת.

      לדוגמה, כדי להשלים את ההתקנה של ZoomKeeper ו-Cassandra, משתמשים בפקודה הבאה:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      configFile הוא קובץ התצורה של Edge.

      לחלופין, כדי לבצע התקנה של 'הכל באחד', משתמשים בפקודה הבאה:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

המיקום של קובצי התצורה להתקנה

צריך להעביר לכלי השירות apigee-setup קובץ תצורה שמכיל את המידע על התקנת Edge. הדרישה היחידה בהתקנות שקטות היא שקובץ התצורה יהיה נגיש או קריא למשתמש ה-apigee. לדוגמה, מעבירים את הקובץ לספרייה /usr/local/var או /usr/local/share בצומת, ו-chown נותנים אותו ל-'apigee:apigee'.

כל המידע בקובץ התצורה נדרש מלבד סיסמת האדמין של מערכת Edge. אם משמיטים את הסיסמה, כלי השירות apigee-setup מציג הנחיה להזין אותה בשורת הפקודה.

למידע נוסף, ראו התקנת רכיבי Edge בצומת.

טיפול בכשל בהתקנה

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

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

התקנה דרך אינטרנט או התקנה שלא דרך אינטרנט

כדי להתקין את Edge בצומת, הצומת צריך להיות מסוגל לגשת למאגר Apigee:

  • צמתים עם חיבור חיצוני לאינטרנט

    צמתים עם חיבור חיצוני לאינטרנט ניגשים למאגר של Apigee כדי להתקין את ה-RPM ויחסי התלות ב-Edge.

  • צמתים ללא חיבור חיצוני לאינטרנט

    צמתים ללא חיבור חיצוני לאינטרנט יכולים לגשת לגרסה משוכפלת של מאגר Apigee שהגדרתם באופן פנימי. המאגר הזה מכיל את כל ה-RPM של Edge, אבל צריך לוודא שיש לכם את כל יחסי התלות האחרים שזמינים ממאגרים ברשת הפנימית.

    כדי ליצור את מאגר הנתונים הפנימי של Apigee, צריך צומת עם גישה חיצונית לאינטרנט, כדי שתהיה אפשרות להוריד את ההכנסות לאלף חשיפות ויחסי התלות ב-Edge. אחרי שיוצרים את המאגר הפנימי, אפשר להעביר אותו לצומת אחר או להפוך את הצומת לנגיש לצמתים של Edge לצורך התקנה.

שימוש במאגר מקומי של Edge כדי לשמור על גרסת Edge

אחת מהסיבות להשתמש במאגר מקומי או במאגר בענן ובמחשב היא להתקין את Edge בצמתים ללא חיבור חיצוני לאינטרנט, כמו שמתואר בקטע הקודם.

פתרון יחסי תלות של התקנות לפי הכנסה לאלף צפיות (RPM)

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

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

פקודות Yum נפוצות

כלי ההתקנה של Edge ל-Linux מסתמכים על Yum כדי להתקין ולעדכן רכיבים. יכול להיות שתצטרכו להשתמש במספר פקודות Yum כדי לנהל התקנה בצומת.

  • מנקים את כל המטמון של Yum: 
    sudo yum clean all
  • כדי לעדכן רכיב Edge: 
    sudo yum update componentName

    למשל:

    sudo yum update apigee-setup
sudo yum update edge-management-server

המבנה של מערכת הקבצים

Edge מתקין את כל הקבצים בספרייה /opt/apigee.

במדריך הזה ובמדריך הפעולות של הקצה, ספריית ההתקנה הבסיסית (root) מצוינת כך:

/opt/apigee

ההתקנה משתמשת במבנה הבא של מערכות קבצים כדי לפרוס את Apigee Edge לענן פרטי.

קובצי יומן

קובץ היומן של apigee-setup והסקריפט setup.sh נכתב אל /tmp/setup-root.log.

קובצי היומן של כל רכיב נמצאים בספרייה /opt/apigee/var/log. לכל רכיב יש ספריית משנה משלו. לדוגמה, היומנים של שרת הניהול נמצאים בספרייה:

/opt/apigee/var/log/edge-management-server

בטבלה הבאה מוצג המיקום של קובצי היומן:

רכיב מיקום

שרת ניהול

 /opt/apigee/var/log/edge-management-server

נתב

 /opt/apigee/var/log/edge-router

ה-Edge Router מוטמע באמצעות Nginx. ליומנים נוספים:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

מעבד בקשות

 /opt/apigee/var/log/edge-message-processor

שרת Qpid של Apigee

 /opt/apigee/var/log/edge-qpid-server
שרת Apigee Postgres /opt/apigee/var/log/edge-postgres-server
ממשק משתמש קלאסי (לא ממשק המשתמש החדש של Edge, ששם הרכיב שלו הוא edge-management-ui) /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
קסנדרה /opt/apigee/var/log/apigee-cassandra/system.log
קפיד /opt/apigee/var/log/apigee-qpidd
מסד נתונים של PostgreSQL /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

נתונים

רכיב מיקום
שרת ניהול /opt/apigee/data/edge-management-server
נתב /opt/apigee/data/edge-router
מעבד בקשות /opt/apigee/data/edge-message-processor
סוכן Qpid של Apigee /opt/apigee/data/edge-qpid-server
סוכן Apigee Postgres /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
קסנדרה /opt/apigee/data/apigee-cassandra/data
קפיד /opt/apigee/data/apigee-qpid/data
מסד נתונים של PostgreSQL /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

הפעלת בדיקת המערכת במהלך ההתקנה

קובץ התצורה של התקנת Edge תומך במאפיינים הבאים:

ENABLE_SYSTEM_CHECK=y

אם מגדירים את המאפיין הזה כ-y, מנהל ההתקנה בודק שהמערכת עומדת בדרישות המעבד (CPU) והזיכרון של הרכיב שמותקן. ערך ברירת המחדל הוא 'n' כדי להשבית את הבדיקה.