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 Recordinghook (ADAH) ואת Apigee Deployment Controller (ADC). ראו ao במאמר העזרה של מאפיין ההגדרה. (151250559)

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

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

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

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

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

נוספו מאפיינים חדשים של הגדרות אישיות שמספקים יותר גמישות בדרך אתם מציינים אישורי 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) לפני שהם שולחים אותם לניתוח נתונים

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

הרחבת נפחים קבועים (Statesfulsets)

נוספה תכונה שמאפשרת לך להרחיב את הנפח הקבוע שמשמש את apigee-cassandra כדי להתאים לצורכי האחסון בלי להוסיף עוד כוח מחשוב. מידע נוסף זמין במאמר הבא: הרחבת נפחי אחסון מתמיד (persistent disks) ל-Statefulsets. (138167919)

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

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

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

שני מאפייני תצורה חדשים מאפשרים להגדיר את גרסת TLS המינימלית והמקסימלית עבור תעבורת הנתונים הנכנסת (ingress): 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> המדיניות בנושא &lt;PropertySetRef&gt; מאפשרת ליצור באופן דינמי צמד של שם/מפתחות של קבוצת נכסים. התכונה הזו זמינה רק לשרתי proxy ל-API שנפרסו ב-Apigee hybrid. צפייה AssignVariable (הקצאה) (148612340)

הבאגים תוקנו

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

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

בעיות מוכרות

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

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

שגיאה לא תקינה של כותרת 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 אם יוצרים סשן של ניפוי באגים אבל עדיין אין בו עסקאות. לאחר מכן List Debug Sessions API לא כולל את הסשן ברשימה הזו. ה-API כולל רק סשנים בתגובה אם הסשן מכיל לפחות עסקה אחת.
143659917

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

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

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

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