Edge for Private Cloud גרסה 4.17.05
הקטע הזה עוסק בפעולות ניהוליות שונות, כמו יצירה, ניהול והסרה של ארגונים, סביבות ומארחים וירטואליים ב-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 לכל הקריאות. אם הבדיקות נכשלות, צריך לבצע את הפעולות הבאות:
- מומלץ לבדוק אם יש שגיאות ביומנים של Management Server בכתובת /opt/apigee/var/log/apigee/management-server.
- צריך לבצע קריאה לשרת הניהול כדי לבדוק אם הוא פועל באופן תקין.
- מסירים את השרת מה-ELB ולאחר מכן מפעילים מחדש את שרת הניהול:
/opt/apigee/bin/apigee-service management-server מחדש
מידע על השימוש בקובצי תצורה
לפקודות שמוצגות למטה יש קובץ תצורה בתור קלט. לדוגמה, אפשר להעביר קובץ 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 של הנתב ומעבירים את כינוי המארח.
הערה: פקודת ה-curl, רוב הדפדפנים ואפליקציות רבות נוספות מצרפת באופן אוטומטי את כותרת המארח לדומיין כחלק מהבקשה, כך שתוכלו להשתמש בפועל בפקודת curl בפורמט הבא:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
אפשרויות כשאין רשומת 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}