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

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

כתוצאה מכך, ב-Apigee מומלץ שפריסות גדולות יותר ישתמשו ב-HTTP ולא ב-RPC בפריסה גמישה.

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

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

עדכון הארגון

כדי להפעיל פריסת HTTP, צריך לשלוח בקשת PUT עדכון ה-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, מומלץ להגדיר ב-Apigee את הנכס הזה 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.

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