הקטע הזה עוסק בפעולות ניהוליות שונות, כמו יצירה, ניהול והסרה של ארגונים, סביבות ומארחים וירטואליים ב-Apigee Edge להתקנת ענן פרטי.
לקבלת מבוא לארגונים, סביבות ומארחים וירטואליים, ראו מידע על כוכבי לכת, אזורים, pods, ארגונים, סביבות ומארחים וירטואליים.
בדיקת הסטטוס של משתמשים, ארגון וסביבה
לשרת הניהול יש תפקיד חיוני בהחזקה של כל הרכיבים האחרים בהתקנה מקומית של ענן פרטי של Edge. אפשר לבדוק את סטטוס המשתמש, הארגון והפריסה בשרת הניהול, באמצעות פקודות curl
הבאות:
curl -u adminEmail:admin_passwd http://localhost:8080/v1/userscurl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments
המערכת צריכה להציג סטטוס HTTP 200 לכל הקריאות. אם הבדיקות נכשלות, צריך לבצע את הפעולות הבאות:
- כדאי לבדוק אם יש שגיאות ביומנים של שרת הניהול ב-
/opt/apigee/var/log/apigee/management-server
. - צריך לבצע קריאה לשרת הניהול כדי לבדוק אם הוא פועל באופן תקין.
- מסירים את השרת מה-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