Edge for Private Cloud גרסה 4.16.05
בקטע הזה נסביר על פעולות ניהול שונות, כמו יצירה, ניהול והסרה של ארגונים, סביבות ומארחים וירטואליים של Apigee בהתקנה של Apigee Edge for Private Cloud.
במאמר מידע על כוכבי לכת, אזורים, פודים, ארגונים, סביבות ומארחים וירטואליים מוסבר על ארגונים, סביבות ומארחים וירטואליים.
בדיקת הסטטוס של המשתמשים, הארגון והסביבה
לשרת הניהול יש תפקיד חיוני בחיבור בין כל הרכיבים האחרים בהתקנה מקומית של 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 לכל הקריאות. אם זה לא עובד, נסו את הפעולות הבאות:
- בודקים אם יש שגיאות ביומני שרת הניהול בנתיב <inst_root>/apigee/var/log/apigee/management-server.
- מבצעים קריאה לשרת הניהול כדי לבדוק אם הוא פועל כמו שצריך.
- מסירים את השרת מה-ELB ואז מפעילים מחדש את שרת הניהול:
/<inst_root>/apigee/bin/apigee-service management-server restart
מידע על שימוש בקובצי תצורה
הפקודות שמוצגות בהמשך מקבלות קובץ תצורה כקלט. לדוגמה, אתם מעבירים קובץ תצורה לפקודה setup-org כדי להגדיר את כל המאפיינים של הארגון, כולל הסביבה והמארח הווירטואלי.
כדי לראות קובץ תצורה מלא ומידע על המאפיינים שאפשר להגדיר בקובץ התצורה, קראו את המאמר הצטרפות של ארגון.
מידע על הגדרת מארח וירטואלי
מארח וירטואלי ב-Edge מגדיר את הדומיינים ואת היציאות של Edge Router שבהם proxy ל-API חשוף, ובהתאם לכך, את כתובת ה-URL שבה אפליקציות משתמשות כדי לגשת ל-proxy ל-API. מארח וירטואלי גם מגדיר אם הגישה ל-proxy ל-API מתבצעת באמצעות פרוטוקול HTTP או באמצעות פרוטוקול HTTPS מוצפן.
כדי ליצור מארח וירטואלי, משתמשים בסקריפטים ובקריאות ל-API שמוצגים בהמשך. כשיוצרים את המארח הווירטואלי, צריך לציין את הפרטים הבאים:
- השם של המארח הווירטואלי שמשמש להפניה אליו בשרתי ה-proxy ל-API.
- היציאה בנתב של המארח הווירטואלי. בדרך כלל היציאות האלה מתחילות ב-9001 וגדלות ב-1 לכל מארח וירטואלי חדש.
- כינוי המארח של המארח הווירטואלי. בדרך כלל שם ה-DNS של המארח הווירטואלי.
הנתב של Edge משווה בין הכותרת Host של הבקשה הנכנסת לבין רשימת הכינויים של המארח, כחלק מההחלטה איזה שרת proxy ל-API יטפל בבקשה. כששולחים בקשה דרך מארח וירטואלי, צריך לציין שם דומיין שתואם לכינוי המארח של המארח הווירטואלי, או לציין את כתובת ה-IP של הנתב ואת הכותרת Host שמכילה את כינוי המארח.
לדוגמה, אם יצרתם מארח וירטואלי עם כינוי מארח 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}