הפעלה של פריסת 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.

בדוגמה הבאה מתבצעת קריאה ל-עדכון מאפייני הארגון בגוף הודעת ה-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.

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