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

Edge for Private Cloud גרסה 4.17.05

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

תהליך ההתקנה

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

• משביתים את SELinux בצומת או מגדירים אותו למצב מתירני. מידע נוסף זמין במאמר התקנת כלי השירות apigee-setup של Edge.
• מחליטים אם רוצים להפעיל אימות של Cassandra.
• מחליטים אם רוצים להגדיר רפליקציה של מאסטר-המתנה ל-Postgres.
• בוחרים את הגדרת ה-Edge מרשימת הטופולוגיות המומלצות. לדוגמה, אפשר להתקין את Edge בצומת אחד לבדיקה, או ב-13 צמתים לייצור. מידע נוסף זמין במאמר טופולוגיות התקנה.
• בכל צומת בטופולוגיה שבחרתם, מתקינים את כלי השירות apigee-setup של Edge:
  • מורידים את הקובץ bootstrap_4.17.05.sh של Edge אל ‎/tmp/bootstrap_4.17.05.sh.
  • מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות.
  • מתקינים את כלי השירות apigee-setup של Edge ואת יחסי התלות.
    
    מידע נוסף זמין במאמר התקנת כלי השירות apigee-setup של Edge.
• משתמשים בכלי apigee-setup כדי להתקין רכיב אחד או יותר של Edge בכל צומת, בהתאם לטופולוגיה שבחרתם.
  התקנת רכיבי Edge בצומת.
• בצומת של שרת הניהול, משתמשים בכלי apigee-setup כדי להתקין את apigee-provision, הכלים שמשמשים ליצירה ולניהול של ארגונים ב-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. משנים את הבעלים של הקובץ ל-"apigee:apigee" באמצעות הפקודה chown. אם שיניתם את המשתמש שמפעיל את שירות Edge מהמשתמש "apigee", משנים את הבעלים של הקובץ למשתמש שמפעיל את שירות Edge באמצעות הפקודה chown.

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

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

1. משימות שבוצעו על ידי משתמש הבסיס:
   1. מורידים ומריצים את הקובץ bootstrap_4.17.05.sh:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
      
      בשלב הזה מתקינים את כלי השירות apigee-service ויוצרים את המשתמש "apigee".
   2. מגדירים למשתמש גישת 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-ui,‏ 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.
      
      לחלופין, כדי לבצע התקנה של All-in-One, משתמשים בפקודה הבאה:
      > ‎/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

מיקום קובצי התצורה של ההתקנה

צריך להעביר קובץ תצורה לכלי apigee-setup שמכיל את המידע על התקנת Edge. הדרישה היחידה בהתקנות שקטות היא שקובץ התצורה יהיה נגיש או קריא למשתמש "apigee". לדוגמה, שומרים את הקובץ בספרייה ‎/usr/local/var או ‎/usr/local/share בצומת ומשנים את הבעלים שלו ל-"apigee:apigee".

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

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

טיפול בשגיאה בהתקנה

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

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

כדי להתקין את Edge בצומת, הצומת צריך להיות מסוגל לגשת למאגר של Apigee:

• צמתים עם חיבור חיצוני לאינטרנט
  
  צמתים עם חיבור חיצוני לאינטרנט ניגשים למאגר של Apigee כדי להתקין את ה-RPMs והתלויות של Edge.
• צמתים ללא חיבור חיצוני לאינטרנט
  
  צמתים ללא חיבור חיצוני לאינטרנט יכולים לגשת לגרסה משוכפלת של מאגר Apigee שהגדרתם באופן פנימי. המאגר הזה מכיל את כל קובצי ה-RPM של Edge, אבל צריך לוודא שכל שאר יחסי התלות זמינים ממאגרים ברשת הפנימית.
  
  כדי ליצור את המאגר הפנימי של Apigee, צריך צומת עם גישה לאינטרנט חיצוני כדי להוריד את ה-RPM של Edge ואת יחסי התלות. אחרי שיוצרים את המאגר הפנימי, אפשר להעביר אותו לצומת אחר או להפוך את הצומת הזה לנגיש לצומתי Edge לצורך התקנה.

שימוש במאגר מקומי של Edge כדי לשמור על גרסת Edge

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

עם זאת, יש יתרון נוסף לשימוש במאגר מקומי, גם לצמתים עם חיבור חיצוני לאינטרנט. כשמתקינים את Edge מהמאגר הציבורי של Apigee, תמיד מתקינים את קובצי ה-RPM העדכניים ביותר של Edge. לכן, אם רוצים להוריד ולאחסן קובצי RPM של Edge לגרסה ספציפית של Edge, צריך ליצור מאגר מקומי לגרסה הזו של Edge. אחר כך אפשר להשתמש במאגר המקומי הזה כדי להתקין כל גרסה של Edge.

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

מאגר מראה הוא גמיש מאוד. לדוגמה, אתם יכולים ליצור מאגר משוכפל מהגרסאות העדכניות ביותר של Edge RPM או מגרסה ספציפית של Edge. אחרי שיוצרים את המאגר, אפשר גם לעדכן אותו כדי להוסיף קובצי RPM מגרסאות שונות של Edge. מידע נוסף זמין במאמר התקנת כלי השירות apigee-setup של 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, ספריית ההתקנה ברמה הבסיסית (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 אחרי ההתקנה, משתמשים בשילוב של קובצי ‎.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 action

לדוגמה, כדי להפעיל מחדש את הנתב של Edge:

/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 – רכיב של Monetization. לדוגמה, edge-mint-management-server.
• ‫baas – רכיב API BaaS. לדוגמה, baas-usergrid.

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

• התחלה, הפסקה, הפעלה מחדש
• סטטוס, גרסה
• גיבוי, שחזור
• התקנה, הסרה