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

Edge for Private Cloud v4.18.05

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

תהליך ההתקנה

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

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

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

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

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

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

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

8. מפעילים מחדש את רכיב ממשק המשתמש של Edge אחרי שההתקנה מסתיימת.

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

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

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

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

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

      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
      sudo bash /tmp/bootstrap_4.18.05.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 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.

מפעילים מחדש את רכיב ממשק המשתמש של Edge.

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

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

הגדרת רכיבי Edge לאחר ההתקנה

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

הקבצים של .properties נמצאים בספרייה /opt/apigee/customer/application. לכל רכיב יש קובץ .properties משלו בספרייה הזו. לדוגמה, router.properties ו-management-server.properties.

כדי להגדיר מאפיין לרכיב, עורכים את קובץ ה-.properties המתאים ואז מפעילים מחדש את הרכיב:

/opt/apigee/apigee-service/bin/apigee-service component restart

לדוגמה:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

כשמעדכנים את Edge, המערכת קוראת את קובצי ה-.properties בספרייה /opt/apigee/customer/application. כלומר, העדכון שומר על כל המאפיינים שהגדרתם ברכיב.

מידע נוסף על הגדרת Edge זמין במאמר איך מגדירים את Edge.

הפעלת פקודות ברכיבי Edge

‫Edge מתקין כלי ניהול ב-/opt/apigee/apigee-service/bin, שבהם אפשר להשתמש כדי לנהל את ההתקנה של Edge. לדוגמה, אפשר להשתמש בכלי apigee-all כדי להפעיל, לעצור, להפעיל מחדש או לקבוע את הסטטוס של כל רכיבי Edge בצומת:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

משתמשים בכלי apigee-service כדי לשלוט ברכיבים ספציפיים ולהגדיר אותם. הפורמט של הכלי apigee-service הוא:

/opt/apigee/apigee-service/bin/apigee-service component_name action

‫component_name הוא המזהה של הרכיב. הרכיב חייב להיות בצומת שבו מפעילים את apigee-service. בהתאם להגדרות האישיות, הערכים של component_name יכולים לכלול:

• apigee-cassandra (קסנדרה)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (מסד נתונים של PostgreSQL)
• apigee-qpidd (קיפוד)
• apigee-sso (כניסה יחידה (SSO))
• apigee-zookeeper (ZooKeeper)
• edge-management-server (שרת ניהול)
• edge-management-ui (ממשק קצה חדש של Edge)
• edge-message-processor (מעבד הודעות)
• edge-postgres-server (שרת Postgres)
• edge-qpid-server (שרת Qpid)
• edge-router (נתב קצה)
• edge-ui (ממשק משתמש קלאסי)

בנוסף לרכיבים האלה, אפשר גם להפעיל את apigee-service ברכיבים apigee-provision ו-apigee-validate, בהתאם להגדרות האישיות.

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

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

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

• ‫apigee: רכיב של צד שלישי שמשמש את Edge. לדוגמה, apigee-cassandra.
• ‫edge: רכיב Edge מ-Apigee. לדוגמה, edge-management-server.
• ‫edge-mint: רכיב מונטיזציה. לדוגמה, edge-mint-management-server.

רשימת הפעולות המלאה של רכיב תלויה ברכיב עצמו, אבל כל הרכיבים תומכים בפעולות הבאות:

• start, stop, restart
• status, version
• backup, restore
• install, uninstall

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

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

ENABLE_SYSTEM_CHECK=y

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