הפעלה של פריסת HTTP

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

לכן, ב-Apigee מומלץ להשתמש ב-HTTP במקום ב-RPC לפריסות גדולות יותר.

בנוסף לשיפור הפוטנציאלי באמינות, הפעלת פריסת HTTP גם משפרת את התוכן והפורמט של חריגות שעשויות להתרחש במהלך תהליך הפריסה.

בקטע הזה מוסבר איך להפעיל HTTP לפריסה.

עדכון הארגון

כדי להפעיל פריסת HTTP, שולחים בקשת PUT אל Update organization properties API. מגדירים את המאפיינים הבאים בגוף הבקשה:

נכס תיאור
allow.deployment.over.http ההגדרה קובעת אם Edge יכול לפרוס שרתי proxy ל-API באמצעות HTTP (בנוסף ל-RPC). מגדירים את הערך true כדי לאפשר פריסת HTTP, אחרת מגדירים את הערך false. ערך ברירת המחדל הוא false.

כדי להפעיל פריסות HTTP, צריך להגדיר את המאפיין הזה לערך true.
use.http.for.configuration

מציינת באיזו שיטה להשתמש לאירועי הגדרה. הערכים שאפשר לבחור הם:

  • ‫never: כל אירועי ההגדרות משתמשים ב-RPC. זוהי אפשרות ברירת המחדל.
  • ‫retry: כל אירועי ההגדרות משתמשים קודם ב-RPC. אם אירוע נכשל דרך RPC, ‏Edge מנסה להשתמש ב-HTTP. אם אתם צריכים להשתמש ב-HTTP, זה עלול לגרום לעיכובים.
  • ‫always: כל אירועי ההגדרה משתמשים ב-HTTP.

כדי להפעיל פריסות HTTP, מומלץ להגדיר את המאפיין הזה לערך always.

בנוסף להגדרת המאפיינים האלה בגוף ההודעה, צריך להגדיר את הכותרת Content-Type לערך application/json או application/xml.

בדוגמה הבאה מתבצעת קריאה ל-Update organization properties API עם גוף הודעה בפורמט JSON.

curl -u admin_email:admin_password
  "http://management_server_IP:8080/v1/organizations/org_name"
  -X POST -H "Content-Type: application/json" -d
  '{
    "properties" : {
      "property" : [
      {
        "name" : "allow.deployment.over.http",
        "value" : "true"
      },
      {
        "name" : "use.http.for.configuration",
        "value" : "always"
      } ]
    }
  }'

כדי להפעיל פריסת HTTP בכל שרתי ה-proxy ל-API בכל הארגונים, צריך לעדכן כל ארגון כמו שמתואר למעלה.

בדיקת העדכון

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

מידע נוסף זמין במאמר בנושא קובצי יומן.