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

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

לכן, ב-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 בכל שרת ה-API שמשמש כשרתי proxy בכל הארגונים שלכם, עליכם לעדכן כל ארגון כפי שמתואר למעלה.

בדיקת העדכון

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

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