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

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

תהליך ההתקנה

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

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

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.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 בצומת.

      לדוגמה, כדי להשלים את ההתקנה של 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, נדרש צומת עם גישה חיצונית לאינטרנט כדי שתוכלו להוריד את יחידות ה-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

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

נתונים

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

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

ENABLE_SYSTEM_CHECK=y

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