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

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

תהליך ההתקנה

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

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

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

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 מותקנים כקבוצה של יחסי תלות ו-RPM. כדי להתקין, להסיר ולעדכן חבילות RPM של Edge, צריך להריץ את הפקודות באמצעות משתמש root או משתמש עם הרשאת 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 הנדרשים). לאחר מכן, צריך הרשאת 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', צריך להשתמש בפקודה chown כדי להקצות את הקובץ למשתמש שמפעיל את שירות Edge.

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

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

1. משימות שמבוצעות על ידי root:
   1. מורידים ומריצים את הקובץ bootstrap_4.50.00.sh:

      curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
      sudo bash /tmp/bootstrap_4.50.00.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. אחרי שמשתמש root מתקין את ה-RPM של Edge בצומת, המשתמש עם הרשאת sudo מלאה למשתמש 'apigee' משלים את תהליך ההגדרה:
   1. משתמשים בכלי setup.sh כדי להשלים את ההגדרה של רכיבי Edge בצומת. צורת הפקודה תלויה ברכיבים שהותקנו בצומת. רשימה מלאה מופיעה במאמר התקנת רכיבי Edge בצומת.

      לדוגמה, כדי להשלים את ההתקנה של ZooKeeper ו-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, נדרש צומת עם גישה חיצונית לאינטרנט כדי שתוכלו להוריד את יחידות ה-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 Router מוטמע באמצעות Nginx. יומנים נוספים זמינים במאמרים הבאים: /opt/apigee/var/log/edge-router/nginx /opt/nginx/logs
מעבד בקשות	/opt/apigee/var/log/edge-message-processor
שרת Apigee Qpid	/opt/apigee/var/log/edge-qpid-server
שרת Postgres של Apigee	/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
Cassandra	/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
Cassandra	/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' כדי להשבית את הבדיקה.