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

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

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

   /opt/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 Router משווה בין הכותרת 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 של הנתב ומעבירים את כינוי המארח בכותרת המארח.

אפשרויות כשאין רשומת 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