1.1.0 – נתוני הגרסה לזמן ריצה היברידי של Apigee

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X.
מידע

ב-27 בינואר 2020, Google השיקה את גרסה 1.1.0 של סביבת זמן הריצה ההיברידית של Apigee. הקטע הזה מתארת תכונות חדשות ושינויים שהושקו בגרסה 1.1.0.

משדרג

לא ניתן לשדרג מ-1.0.0 ל-1.1.0, והגרסה החדשה אינה תואמת לאחור עם גרסה 1.0.0. גרסה 1.1.0 מחייבת התקנה חדשה.

תכונות חדשות ושיפורים

Apigee Connect (גרסת אלפא)

Apigee Connect Alpha מאפשרת לשירות MART ההיברידי של Apigee להתחבר למישור הניהול בלי שתצטרכו לחשוף את נקודת הקצה של MART. אם משתמשים ב-Apigee Connect, לא צריך להגדיר את שער תעבורת הנתונים הנכנסת (ingress) של MART עם כינוי מארח ו-DNS מורשה אישור. לפרטים נוספים אפשר לפנות לנציג Apigee שלכם.

ניתוב נתיב בסיסי

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

השינויים

בוצעו השינויים הבאים בגרסה 1.1.0 של סביבת זמן ריצה היברידית. חלק מהשינויים האלה, כפי שצוין, אינם תואמים לאחור עם גרסה 1.0.0.

  • ה-CLI של apigeectl מתקין עכשיו את Istio במרחב השמות של istio-system. זהו מרחב השמות שמוגדר כברירת מחדל ב-Istio. השינוי הזה לא תואם לאחור עם גרסה היברידית 1.0.0.
  • ה-CLI של apigeectl מתקין עכשיו את CertManager מרחב השמות cert-manager. השינוי הזה לא תואם לאחור עם גרסה היברידית 1.0.0.
  • הגרסה הנתמכת של Istio שנפרסה באמצעות זמן ריצה היברידי של Apigee הועברה לגרסה 1.4.2 כי גרסה 1.2.x כבר לא נתמכת.

הבאגים תוקנו

תוקנו הבעיות הבאות בנתוני הגרסה 1.0.0 של Apigee hybrid:

בעיה תיאור
144886537 ניתוב הנתיב הבסיסי לא פועל ב-Apigee hybrid v1.0.0. כשמוגדרים השינויים לנתב סביבות שונות עם אותו כינוי מארח, תעבורת הנתונים הנכנסת (ingress) לא מנותבת לסביבה על סמך הנתיב.
143774187 בממשק המשתמש ההיברידי מוצגת התווית 'חברה' בתצוגה 'אפליקציות'.

בעיות מוכרות

בטבלה הבאה מתוארות הבעיות הידועות בגרסה הזו:

בעיה תיאור
לא רלוונטי לא ניתן להשתמש בסימן "*" לנכס hostAlias של mart וגם envs הגדרות. השיטה המומלצת היא להשתמש בשם מארח ספציפי למערך ההגדרות האישיות של mart.
לא רלוונטי הגדרה של HTTP_PROXY, HTTPS_PROXY וגם NO_PROXY משתנים לא נתמכים בגרסת האלפא של Apigee Connect.
לא רלוונטי

שגיאה לא תקינה של כותרת HTTP: תעבורת הנתונים הנכנסת (ingress) של Istio מעבירה את כל תגובות היעד הנכנסות לפרוטוקול HTTP2. מכיוון שמעבד ההודעות ההיברידי תומך רק ב-HTTP1, עשויה להופיע השגיאה הבאה כשנשלחת קריאה לשרת proxy של API:

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

אם השגיאה הזו מופיעה, אפשר לבצע כל אחת מהפעולות הבאות כדי לתקן את :

  • משנים את שירות היעד כדי להשמיט את הכותרת 'מארח' בתשובה.
  • יש להסיר את כותרת המארח באמצעות מדיניות AssignMessage בשרת ה-proxy של ה-API, אם הנחוצים.
144584813 אם יוצרים סשן של ניפוי באגים אבל עדיין אין בו עסקאות. ה-API של רשימת הסשנים של ניפוי הבאגים לא כולל את הסשן ברשימה הזו. ממשק API כולל סשנים בתגובה רק אם הסשן מכיל לפחות עסקה אחת.
144436206 בתצוגה ביצועי המטמון, החישוב של יחס ההיטים במטמון הוא שגוי.
144321491 יומנים היברידיים ב-Apigee 'יצירת מטמון חסר' התראות שמצביעות על פוטנציאל והירידה בביצועים שלהם. ההודעות האלה צפויות להתבצע ואפשר להתעלם מהן.
144321144 לא ניתן לטעון מחדש שרתי proxy עם מארחים וירטואליים מאובטחים.
144286363

מסכת ניפוי הבאגים בקובץ env.json לא מבצעת אנונימיזציה של נתוני התגובות.

ה-API הבא לעדכון מסכת ניפוי הבאגים של env.json עם שדה responseJSONPaths לא פועל:

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

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

143659917

צריך להגדיר את הגדרת התפוגה של המדיניות PopulateCache לערך מפורש בין 1 ל-30. לדוגמה:

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

סיכום: זמן אחזור ארוך מאוד כשמשתמשים ב-API או בממשק המשתמש כדי לקבל סטטוס הפריסה של הארגון. זמן האחזור הזה יכול לגרום לתשובה HTTP 204 (No Content) או HTTP 400 (Bad Request).

פתרון: לרענן את הדפדפן (או לשלוח מחדש את הבקשה).