תחזוקת ארגונים וסביבה

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

לקבלת מבוא לארגונים, סביבות ומארחים וירטואליים, ראו מידע על כוכבי לכת, אזורים, pods, ארגונים, סביבות ומארחים וירטואליים.

בדיקת הסטטוס של משתמשים, ארגון וסביבה

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

curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments

המערכת צריכה להציג סטטוס HTTP 200 לכל הקריאות. אם הבדיקות נכשלות, צריך לבצע את הפעולות הבאות:

1. כדאי לבדוק אם יש שגיאות ביומנים של שרת הניהול ב-/opt/apigee/var/log/apigee/management-server.
2. צריך לבצע קריאה לשרת הניהול כדי לבדוק אם הוא פועל באופן תקין.
3. מסירים את השרת מה-ELB ולאחר מכן מפעילים מחדש את שרת הניהול:

   /opt/apigee/bin/apigee-service management-server restart

מידע על השימוש בקובצי תצורה

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

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

מידע על הגדרת מארח וירטואלי

מארח וירטואלי ב-Edge מגדיר את הדומיינים ואת יציאות Edge Router שבהן חשוף שרת proxy של API. לחלופין, את כתובת ה-URL שבה אפליקציות משתמשות כדי לגשת לשרת proxy של API. מארח וירטואלי גם מגדיר אם הגישה לשרת ה-proxy של ה-API מתבצעת באמצעות פרוטוקול HTTP, או באמצעות פרוטוקול HTTPS מוצפן.

כדי ליצור מארח וירטואלי, משתמשים בסקריפטים ובקריאות ל-API שמוצגים בהמשך. כשיוצרים את המארח הווירטואלי, צריך לציין את הפרטים הבאים:

• שם המארח הווירטואלי שבו משתמשים כדי להפנות אליו בשרתי ה-proxy של ה-API.
• היציאה בנתב של המארח הווירטואלי. בדרך כלל היציאות האלה מתחילות ב-9001 ומצטברות ב-1 לכל מארח וירטואלי חדש.
• כינוי המארח של המארח הווירטואלי. בדרך כלל שם ה-DNS של המארח הווירטואלי.

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

לדוגמה, אם יצרתם מארח וירטואלי עם כינוי מארח של myapis.apigee.net ביציאה 9001, תוכלו להריץ בקשת curl ל-API דרך אותו מארח וירטואלי באמצעות אחד מהטפסים הבאים:

• אם יש לכם רשומת DNS של myapis.apigee.net:

  curl http://myapis.apigee.net:9001/proxy-base-path/resource-path

• אם אין לכם רשומת DNS עבור myapis.apigee.net:

  curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

  בטופס השני, מציינים את כתובת ה-IP של הנתב ומעבירים את כינוי המארח בכותרת המארח.

אפשרויות כשאין רשומת DNS עבור המארח הווירטואלי

אם אין רשומת DNS, אפשרות אחת היא להגדיר את כתובת ה-IP החלופית בתור כתובת ה-IP של הנתב והיציאה של המארח הווירטואלי, בתור routerIP:port. לדוגמה:

192.168.1.31:9001

לאחר מכן, יוצרים פקודת curl בטופס הבא:

curl http://routerIP:9001/proxy-base-path/resource-path

האפשרות הזו מועדפת כי היא פועלת היטב בממשק המשתמש של Edge.

אם יש כמה נתבים, ניתן להוסיף כינוי מארח לכל נתב, ולציין את כתובת ה-IP של כל נתב ויציאה של המארח הווירטואלי.

לחלופין, אפשר להגדיר את הכינוי למארח לערך, כמו temp.hostalias.com. לאחר מכן, צריך להעביר את הכותרת Host בכל בקשה:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

לחלופין, ניתן להוסיף את כתובת המארח החלופית לקובץ /etc/hosts. לדוגמה, מוסיפים את השורה הבאה ל-/etc/hosts:

192.168.1.31   temp.hostalias.com

לאחר מכן אפשר לשלוח בקשה כאילו הייתה רשומת DNS:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path