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

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

תהליך ההתקנה

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

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

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

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

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

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

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

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

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9. מגדירים את האימות וההגדרות האופציונליות לממשק המשתמש החדש של Edge (ששמות הרכיבים שלו הם edge-management-ui ו-edge-management-ui-static).

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

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

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

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

1. יוצרים את הקובץ בכלי לעריכת טקסט בתור משתמש כלשהו.
2. ‫chown הבעלים של הקובץ ל-apigee:apigee או, אם שיניתם את המשתמש שמריץ את שירות Edge מהמשתמש apigee, צריך להגדיר את הבעלים של הקובץ למשתמש שמריץ את שירות Edge.

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

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

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

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.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-management-ui, edge-management-ui-static, 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.

כל המידע בקובץ התצורה נדרש, חוץ מהסיסמה של מנהל המערכת של 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 Operations Guide, ספריית ההתקנה ברמה הבסיסית (root) מצוינת בתור:

/opt/apigee

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

קובצי יומן

קובץ היומן של 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" כדי להשבית את הבדיקה.