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

התקנה טיפוסית של 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.01.sh אל /tmp/bootstrap_4.52.01.sh.
    • מתקינים את כלי העזר ואת יחסי התלות של Edge apigee-service.
    • מתקינים את כלי העזר ואת יחסי התלות של Edge apigee-setup.

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

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

    ראה התקנת רכיבי Edge בצומת.

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

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

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

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

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

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

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

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

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

  • הכלי apigee-service:
    • פקודות apigee-service: install, uninstall, update.
    • הפקודות apigee-all: install, uninstall, update.
  • הסקריפט setup.sh להתקנת רכיבי Edge (אלא אם כבר השתמשתם ב-'apigee-service install' כדי להתקין את ה-RPM הנדרשות. לאחר מכן יש צורך בגישת שורש או בגישת 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 חייבים להיות נגישים למשתמש ה-API. זה כולל את קובץ הרישיון של Edge וכל קובצי התצורה.

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

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

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

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

  1. משימות שמבוצעות על ידי הרמה הבסיסית (root):
    1. מורידים ומריצים את הקובץ bootstrap_4.52.01.sh: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
sudo bash /tmp/bootstrap_4.52.01.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

      ה-RPM של 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. אחרי שמשתמש הבסיס מתקין את ה-RPM של Edge בצומת, המשתמש שיש לו גישת sudo מלאה למשתמש ה-apigee משלים את תהליך ההגדרה:
    1. השתמש בכלי העזר setup.sh כדי להשלים את התצורה של רכיבי Edge בצומת. צורת הפקודה תלויה ברכיבים שהתקנת בצומת. לרשימה מלאה, ראו התקנת רכיבי Edge בצומת.

      לדוגמה, כדי להשלים את ההתקנה של usernameKeeper ו-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. הדרישה היחידה בהתקנות שקטות היא שקובץ התצורה יהיה נגיש או קריא למשתמש ה-API. לדוגמה, מציבים את הקובץ בספרייה /usr/local/var או /usr/local/share בצומת, ואת chown של הקובץ ל-"apigee:apigee".

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

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

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

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

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

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

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

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

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

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

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

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

שימוש במאגר מקומי של Edge לניהול גרסת Edge

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

פתרון יחסי תלות של התקנת RPM

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

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

פקודות נפוצות של 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.

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

/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 מיושם באמצעות 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
Qpidd /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
Qpidd /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' כדי להשבית את הבדיקה.