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

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X.
מידע

ב-3 באפריל 2020 השקנו את גרסה 1.2.0 של זמן ריצה היברידי של Apigee.

משדרג

עדכונים ותכונות חדשות

בהמשך מופיעים התכונות והעדכונים החדשים בגרסה הזו.

נוספה הגדרה חדשה של מארח וירטואלי לציון כללי ניתוב

תכונת ההגדרה החדשה virtualhosts מטפלת בבעיה שבה הסדר שבו הנתיבים הבסיסיים מנותבו לכמה סביבות לא היה ודאי. לפרטים נוספים אפשר לעיין במאמר הגדרת מארחים וירטואליים. (150336519)

גרסת בטא של המדיניות בנושא OASValidation

המדיניות OASValidation (OpenAPI Specification Validation) (בטא) מאפשרת לאמת בקשה או הודעת תגובה נכנסות מול מפרט OpenAPI 3.0 (JSON או YAML). מידע נוסף זמין במאמר המדיניות של OASValidation (בטא). (144949685)

מהדורת בטא של תמיכה ב-WebSocket

התכונה Apigee hybrid תומכת בחיבורי WebSocket. לקוחות proxy של ממשק API יכולים עכשיו לבקש שדרוג פרוטוקול מ-HTTP ל-WebSockets. לפרטים נוספים אפשר לקרוא את המאמר בנושא שימוש ב-WebSockets (בטא).

גישה לערכי סודות של מדיניות מסודות ב-Kubernetes

תכונה חדשה מאפשרת לגשת לערכים שמאוחסנים בסוד של Kubernetes במשתני זרימה של שרת proxy. מידע נוסף מופיע במאמר בנושא אחסון נתונים בסוד של Kubernetes. (133377603)

רכיב Apigee Operators (AO) מחליף את ADAC ו-ADAH

Apigee Operators (AO) יוצר ומעדכן משאבים ברמה נמוכה ב-Kubernetes וב-Istio שנדרשים לפריסה ולתחזוקה של ה-AD. לדוגמה, הבקר מבצע שחרור של מעבדי הודעות. בנוסף, מתבצע אימות של תצורת ApigeeDeployment לפני שמירתה באשכול של Kubernetes. AO מחליף את Apigee Deployment Licensehook (ADAH) ואת Apigee Deployment Controller (ADC). עיינו בחומר העזר בנושא 'הגדרות אישיות'. (151250559)

החלפה והוצאה משימוש של מאפיינים מסוימים של הגדרות אשכול ופרויקטים

נוספו שני מאפיינים חדשים של הגדרות: k8sCluster ו-gcp. המאפיינים האלה מחליפים את המאפיינים הבאים שהוצאו משימוש: k8sClusterName, gcpRegion ו-gcpProjectID. פרטים נוספים זמינים במאמר מידע על נכסים של הגדרות אישיות. (146299599)

הרחבת נפח אחסון מתמיד (persistent disk) ל-Cassandra ב-Kubernetes

נוסף תהליך להרחבת הנפח הקבוע של apigee-cassandra בהתאם לצורכי האחסון, בלי שיהיה צורך להוסיף עוד צמתים רק כדי להגדיל את נפח האחסון. למידע נוסף, ראו הרחבת נפחי האחסון המתמידים של Cassandra. (138167919)

תמיכה במקורות נוספים לאישורים, למפתחות הצפנה ול-SAs

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

  • kmsEncryptionPath
  • kmsEncryptionSecret.key
  • kmsEncryptionSecret.name
  • cassandra.backup.serviceAccountSecretRef
  • cassandra.restore.serviceAccountSecretRef
  • envs[].cacheEncryptionPath
  • envs[].cacheEncryptionSecret.key
  • envs[].cacheEncryptionSecret.name
  • envs[].kmsEncryptionPath
  • envs[].kmsEncryptionSecret.key
  • envs[].kmsEncryptionSecret.name
  • envs[].serviceAccountSecretRefs.synchronizer
  • envs[].serviceAccountSecretRefs.udca
  • envs[].sslSecret
  • logger.serviceAccountSecretRef
  • mart.serviceAccountSecretRef
  • mart.sslSecret
  • metrics.serviceAccountSecretRef
  • synchronizer.serviceAccountSecretRef
  • udca.serviceAccountSecretRef

מידע נוסף זמין במאמר מידע על מאפיינים של הגדרות אישיות. (145303466)

מתן אפשרות ללקוחות לבצע ערפול קוד (obfuscation) לפני שליחתם ל-Analytics

נוספה תכונה שמאפשרת לבצע ערפול קוד (obfuscation) של נתוני ניתוח מסוימים לפני שהם נשלחים למישור הניהול. מידע נוסף מופיע במאמר ערפול נתוני משתמשים לצורך ניתוח נתונים. (142578910)

הרחבת נפחים קבועים של קובצי Statefulset

נוספה תכונה שמאפשרת להרחיב את הנפח הקבוע שמשמש את apigee-cassandra כדי לתת מענה לצורכי האחסון, בלי להוסיף כוח מחשוב. למידע נוסף, תוכלו לקרוא את המאמר הרחבת נפחים קבועים של קובצי Statefulset. (138167919)

השדרוג המינימלי של הגרסאות הנתמכות של GKE , Anthos ו-AKS

ב-Apigee hybrid יש תמיכה עכשיו ב-GKE 1.14.x, ב-Anthos 1.2 וב-AKS 1.14.x. (149578101)

תמיכה ב-TLS 1.3 לחיבורים לכיוון צפון

שני מאפייני תצורה חדשים מאפשרים להגדיר גרסת TLS מינימלית ומקסימלית לתעבורת הנתונים הנכנסת: ingress.minTLSProtocolVersion ו-maxTLSProtocolVersion. הערכים האפשריים הם 1.0, 1.1, 1.2 ו-1.3. מידע נוסף זמין במאמר מידע על מאפיינים של הגדרות אישיות. (117580780)

תמיכה בהגדרת שרת proxy להעברה לזמן ריצה היברידי

מעכשיו יש תמיכה בשרת proxy להעברה מסוג HTTP באמצעות שרתי proxy של API שנפרסו בסביבה. לפרטים נוספים אפשר לעיין במאמר הגדרת העברה של שרת proxy להעברה. (148970527)

תמיכה במספר כינויים של מארחים לכל סביבה

נוסף מאפיין חדש של הגדרות אישיות, envs[].hostAliases. בנכס הזה אפשר להוסיף כמה כתובות אימייל חלופיות של מארחים לסביבה. יש להשתמש ברכיב הזה במקום ב-hostAlias, שהוצא משימוש. לפרטים נוספים, אפשר לקרוא את המאמר הוספת כמה כתובות אימייל חלופיות של מארחים לסביבה. (150738495)

שימוש בתבניות עבור קבוצות נכסים

רכיב חדש <PropertySetRef> נוסף לרכיב <assignVariable> של המדיניות <assignMessage>. <PropertySetRef> מאפשר ליצור באופן דינמי צמד שם/מפתח של קבוצת נכסים. התכונה הזו זמינה רק בשרתי proxy של API שנפרסו ב-Apigee היברידי. לפרטים, קראו את המאמר AssignVariable. (148612340)

הבאגים תוקנו

הבאגים הבאים תוקנו בגרסה הזו. הרשימה הזו מיועדת בעיקר למשתמשים שבודקים אם כרטיסי התמיכה שלהם תוקנו. הוא לא נועד לספק מידע מפורט לכל המשתמשים.

מזהה הבעיה שם הרכיב התיאור
147958049 זמן ריצה פתרנו בעיית תזמון ברצף של אתחול בזמן ריצה, שמנעה לפעמים מהמסנכרן להפעיל כראוי.
149867244 פלטפורמת K8S רצף ההגדרה של APIgee-cps נכשל בהגדרה במספר אזורים
150187652 / 149117839 זמן ריצה לא ניתן להשתמש במקפים בשמות של סביבות.
149220463 צוות MP היה צורך לפרוס מחדש שרתי proxy שנפרסו בעבר.
144321144 זמן ריצה לא ניתן היה לטעון מחדש שרתי proxy עם מארחים וירטואליים מאובטחים.
147685310 זמן ריצה כשל בהפעלת הסנכרון עקב אחזור אסימון GCP נכשל במהלך האתחול.
151115900 זמן ריצה לא התרחשה בדיקה תקופתית פנימית לגבי HybridMART שהובילה לתוצאות חיוביות כוזבות.

בעיות ידועות

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

בעיה התיאור
לא רלוונטי

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

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

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

  • יש לשנות את שירות היעד כך שכותרת המארח תשמיט בתשובה.
  • אם צריך, מסירים את כותרת המארח באמצעות המדיניות assignMessage בשרת ה-API של שרת ה-API, אם יש בכך צורך.
144584813 אם יצרת סשן של ניפוי באגים אבל עוד לא נצברו בו עסקאות, ה- List Debug Sessions API לא יכלול את הסשן ברשימה הזו. ה-API כולל סשנים בתגובה רק אם הסשן מכיל טרנזקציה אחת לפחות.
143659917

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

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

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

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