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

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

תהליך ההתקנה

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

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

     מידע נוסף זמין במאמר בנושא התקנת כלי השירות 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. (מומלץ) אחרי שמסיימים את ההתקנה הראשונית, 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 הנדרשים). לאחר מכן, גישת 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.

הגדרת הרשאות בקובצי הגדרה

המשתמש 'apigee' צריך להיות בעל גישה לכל הקבצים או המשאבים שמשמשים את פקודות Edge. הגיבוי הזה כולל את קובץ הרישיון של 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

      חבילות ה-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 בצומת.

      לדוגמה, כדי להשלים את ההתקנה של 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 בצומת ולשנות את הבעלות שלו ל-apigee:apigee.chown

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

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

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

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

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

התקנה עם או בלי חיבור לאינטרנט

כדי להתקין את 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 Operations, ספריית ההתקנה הבסיסית מצוינת כך:

/opt/apigee

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

קובצי יומן

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

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

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

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

נתונים

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

קובץ ההגדרות של התקנת Edge תומך במאפיין הבא:

ENABLE_SYSTEM_CHECK=y

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