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

Edge for Private Cloud v4.19.01

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

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

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

לשרת הניהול יש תפקיד חיוני בהחזקה של כל שאר הרכיבים בהתקנה מקומית של Edge Private Cloud. כדי לבדוק את סטטוס המשתמש, הארגון והפריסה בשרת הניהול, אפשר להשתמש בפקודות 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

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

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

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

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

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

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

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

  Edge Router משווה את הכותרת Host של הבקשה הנכנסת לרשימה של כינויי המארחים, כחלק מהקביעה של שרת ה-API proxy שיטפל בבקשה. כששולחים בקשה דרך מארח וירטואלי, צריך לציין שם דומיין שתואם לכתובת החלופית של המארח הווירטואלי, או לציין את כתובת ה-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 של הנתב ומעבירים את הכינוי של המארח בכותרת Host.

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

אם אין לכם רשומת DNS, אפשר להגדיר את הכינוי של המארח לכתובת ה-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