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

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

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

בתהליך שדרוג

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

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

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

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

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

ניתוב נתיב בסיס מאפשר לכם להגדיר ולנהל את האופן שבו Apigee Hybrid מנתב קריאות ל-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 Hybrid הועברה לגרסה 1.4.2 כי גרסה 1.2.x כבר לא נתמכת.

באגים שתוקנו

הבעיות הבאות שמפורטות בהערות הגרסה של Apigee Hybrid 1.0.0 תוקנו:

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

בעיות מוכרות

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

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

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

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

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

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

המסכה לניפוי באגים ב-env.json לא מסתירה את נתוני התגובה.

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

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

כדי לעקוף את הבעיה הזו ב-Trace, אפשר למחוק סשן שלם של מעקב בממשק המשתמש, או להשתמש ב-Trace APIs כדי למחוק טרנזקציות נפרדות בסשן.
143659917

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

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

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

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