4.16.05 – נתוני גרסה של Edge לענן פרטי

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

ביום שלישי, 31 במאי 2016, השקנו גרסה חדשה של Apigee Edge לענן פרטי.

מאז הגרסה הקודמת של Edge לתכונה 'ענן פרטי' (4.16.01), בוצעו הגרסאות הבאות והן נכללות בגרסת התכונה הזו:

מומלץ לקרוא את המאמר מידע על מספור גרסאות כדי להבין איך לברר אם גרסת ענן ספציפית כלולה בגרסה של Edge לענן פרטי.

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

בהמשך מפורטים התכונות והשיפורים החדשים שבגרסה הזו. בנוסף לשיפורים הבאים, יש בגרסה הזו גם כמה שיפורים מבחינת נוחות השימוש, הביצועים, האבטחה והיציבות.

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

מדריכי התקנה ותפעול הועברו לאינטרנט

עכשיו אפשר לגשת למדריך Edge להתקנה ולפעולות של ענן פרטי בגרסה 4.18.01.

עדכוני תוכנה

עדכוני התוכנה הבאים כלולים בגרסה:

  • Java JDK 1.8 – כדי לנצל את התכונות החדשות של Java, גרסה זו תואמת ל-Java 1.8. בסביבה שלך נדרשים Oracle JDK 1.8 או OpenJDK 8.
    במסגרת העדכון ל-Java 8, חלק מהצפנות TLS כבר לא זמינות ב-Oracle JDK 1.8. לרשימה המלאה, ניתן לעיין בקטע 'חבילות הצפנה כברירת מחדל מושבתות' http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13 – עודכן מ-Cassandra 2.0.15.

התקנה, שדרוג, החזרה לגרסה קודמת

בהמשך מופיעה רשימה של השינויים בהתקנה, בשדרוג ובסקריפטים הקשורים. למידע נוסף על השימוש, תוכלו לקרוא את מסמכי התיעוד של Edge לענן פרטי.

  • תהליך חדש לעדכון מ-4.16.01 – גרסה זו מחליפה את תוכנת העזר apigee-migrate בכלי העזר update.sh כדי לעדכן את ההתקנה מ-4.16.01 ל-4.16.05. אפשר לקרוא מידע נוסף בקטע עדכון Apigee Edge 4.16.01 ל- 4.16.05.
  • סטראפ
    • bootstrap.sh (גרסה 4.16.01) היא עכשיו bootstrap_4.16.05.sh בגרסה 4.16.05.
    • כבר אין צורך לציין uname:pword כדי להוריד את bootstrap_4.16.05.sh.
  • חזרה לגרסה קודמת – כדי להחזיר עדכון לגרסה 4.16.05, מסירים את הגרסה 4.16.05 של הרכיב ומתקינים מחדש את הגרסה הקודמת. תוכנת השירות הקודמת rollback.sh הוסרה. לפרטים, ראו 4.16.05 תהליך החזרה למצב הקודם.
  • setup.sh ו-update.sh יכולים לכתוב את קובץ היומן ב-/tmp - כברירת מחדל, הכלים setup.sh ו-update.sh כותבים את פרטי היומן ב-/opt/apigee/var/log/apigee-setup. אם למשתמש שמפעיל את כלי השירות אין גישה לספרייה הזו, הוא כותב את היומן בספרייה /tmp. אם למשתמש אין גישה אל /tmp, כלי השירות ייכשל.
  • תהליך עדכון ממשקי ה-API BaaS – בגרסה 4.16.01, היה צורך להתקין מחדש את ממשקי BaaS של ה-API כדי להעביר אותם. הכלי החדש update.sh תומך בעדכון BaaS של API. אפשר לקרוא מידע נוסף בקטע עדכון Apigee Edge 4.16.01 ל- 4.16.05.

ניהול

בהמשך מפורטות תכונות חדשות לניהול ולהגדרה של ענן פרטי.

  • אימות התקנה – עכשיו אפשר להריץ את כלי השירות apigee-validate ששימש לבדיקת ההתקנה של ענן פרטי ב-Edge. בעבר, היה צריך להריץ את הסקריפט במעבד ההודעות. למידע נוסף, ראו בדיקת ההתקנה.
  • שם האזור – האזור יכול להיות כל שם. בגרסאות הקודמות, השם היה בצורה "dc-#", כאשר # היה ערך שהוא מספר שלם.
  • רצפי שער - רצפי שער יכולים להיות בכל שם. בגרסאות הקודמות, היה צריך לתת ל-pod שם 'gateway'.
  • ניהול מבוסס סקריפט – כלי חדש לשורת הפקודה apigee-adminapi.sh שמאפשר לבצע את אותן משימות של הגדרת Edge שאתם מבצעים, באמצעות קריאות ל-Edge Management API. למידע נוסף, ראו שימוש בכלי העזר apigee-adminapi.sh.
  • הגדרה שקטה של SSL במארח וירטואלי – מעכשיו כשיוצרים ארגון או סביבה, אפשר להעביר מאפיינים כדי להגדיר SSL במארח וירטואלי. לפרטים, ראו הצטרפות לארגון.

שירותי API

בהמשך מפורטות תכונות חדשות ל-Edge API Services שהוצגו בגרסאות קודמות של המוצר בענן.

קידומת באורך קבוע לרישום הודעות Syslog (Cloud 16.03.30)

המדיניות בנושא רישום הודעות כוללת רכיב <FormatMessage> חדש בתצורה של Syslog. בהגדרה <FormatMessage>true</FormatMessage>, הודעות Syslog מתחילות במספר קבוע של תווים, כך שניתן לסנן נתונים שהוכנסו ל-Apigee. מידע נוסף זמין במדיניות בנושא רישום הודעות ביומן. (APIRT-1398)

תו כללי לחיפוש בנתיב הבסיס של שרת proxy ל-API (ממשק המשתמש של Cloud 16.03.09)

ממשק המשתמש לניהול תומך בשימוש בתו כללי לחיפוש /*/ או יותר בנתיבים בסיסיים של שרת proxy ל-API. לדוגמה, נתיב בסיסי של /team/*/members מאפשר ללקוחות להפעיל את שרת ה-proxy שלך באמצעות https://[host]/team/blue/members או באמצעות https://[host]/team/green/members, בלי שיהיה צורך ליצור שרת proxy חדש כדי לתמוך בצוותים חדשים. חשוב לדעת שאסור להשתמש ב-/**/. (MGMT-3154)

שרשור API Proxy (ממשק Cloud 16.03.02, ממשק משתמש של Cloud 16.03.09)

Edge תומך בחיבור מקומי של שרת proxy ל-API, שמאפשר לשרת proxy של API אחד לקרוא לשרת proxy אחר של API שנפרס בארגון Edge שלך, ללא תקורה נוספת של הרשת. בעבר, כדי ליצור שרשור של שרת proxy ל-API, היה צורך בקריאה מסוג http(s) לשרת proxy אחר ל-API, שהעביר את הבקשה דרך מאזן עומסים, נתב ומעבד הודעות.

רכיבי LocalTargetConnection חדשים זמינים ב-TargetEndpoint של ממשק API ומאפשרים לציין שם של שרת proxy ל-API, את השם של ProxyEndpoint ספציפי בתוך שרת proxy של API, או פשוט את נתיב הבסיס למשאב מקומי של שרת proxy של API (למשל /v1/myresource). ממשק המשתמש של עורך ה-proxy מספק את האפשרויות האלה גם כשמוסיפים או מעדכנים TargetEndpoint.

האפשרות 'שרשור שרת proxy' זמינה גם במדיניות בנושא יתרונות מרכזיים של שירות.

מידע נוסף זמין במאמר שרתי proxy ל-API יחד. גם רכיבי LocalTargetConnection החדשים מפורטים בסכימת ה-XML בכתובת: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

הבאגים תוקנו

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

Edge לענן פרטי 4.16.05

מזהה הבעיה התיאור
PRC-770 מנהל ההתקנה 16.01 לא מצליח לרשום שרת המתנה של Postgres ב-axgroup
PRC-758 משתמש עם תפקיד 'משתמש' יכול לערוך דוחות בהתאמה אישית
PRC-883 העדכון בשרת Postgres עם הגדרת ההמתנה הראשית נכשל

Cloud 16.03.30

מזהה הבעיה התיאור
SECENG-584 בדיקת האימות להוספת שורה חדשה בין אישורים בשרשרת אישורים גורמת לבעיות עם חלק מהאישורים בייצור
MGMT-3217 קריאות ל-Management API נכשלות אם השם של KVMap מסתיים ב-'keys'
MGMT-3214 התנגשויות מחלקות עשויות להתרחש במהלך JavaCallouts, וכתוצאה מכך קוד ה-Java של הלקוח ייכשל
MGMT-3185 שגיאה בהוספת מנהלי ארגון לארגון
EDGEUI-127 קבלת הרשאות לא מספיקות עם עורך ה-proxy החדש
EDGEUI-119 בעיה בזמן הקצוב לתפוגה של סשן בממשק משתמש
CORESERV-671 מופיעה השגיאה "לא הוגדרו טבעות; לא ניתן לאתחל שירות CPs"
AXAPP-2345 בעיה ברישום דוחות בהתאמה אישית ב-AX ללקוחות שלא משלמים על עלות להמרה
AXAPP-2302 בסיכום היומי של Apigee Analytics מוצג הערך אפס בקטע שהמפתחים שלו אימוץ
APIRT-2750 יש כשלים גבוהים בארגון ספציפי
APIRT-2516 שגיאות זמן ריצה בנכסי יתרונות מרכזיים של JavaScript מציינות מספרי שורות שגויים
APIRT-2508 שגיאת יציאה בקריאה להאזנה מהירה בתוך קריאה חוזרת (callback) ב-Vault
APIRT-2336 בעיה ב-Gzip ב-Node.js
APIRT-1975 הגדרות המסכה לא פועלות ב-message.content

ממשק משתמש של Cloud 16.03.16

מזהה הבעיה התיאור
MGMT-3142 תרשימים לא נטענים במרכז הבקרה של ניתוח השגיאות (תיקון מעודכן)

ממשק משתמש של Cloud 16.03.09

מזהה הבעיה התיאור
MGMT-3158 הרשאות לא מספיקות בממשק המשתמש כאשר RBAC מוגדר בשרתי proxy נפרדים באמצעות ה-API
MGMT-3142 התרשימים לא נטענים במרכז הבקרה של ניתוח השגיאות
MGMT-3118 ממשק משתמש מציג הגדרה שגויה של מארח וירטואלי של SSL עבור פרמטר "clientAuthEnabled"
DEVRT-2344 בהגדרות של דוחות ליום אחד לא נטען עסקאות בממשק המשתמש

Cloud 16.03.02

מזהה הבעיה התיאור
MGMT-3083 הרענון האוטומטי של היומנים של Node.js עמוס מדי בהודעות היומן
DEVRT-2275 בתוכניות לתעריפים של מאפיינים מותאמים אישית מוצגים רק 5 מאפיינים במקום 10 מותרים
DEVRT-1275 לא כל המפתחים מופיעים בתפריט הנפתח של תוכנית התעריפים
DEVRT-1074 מפתח שמשלם מראש עם יתרה של אפס מבצע את הפעולה 'Nullpointer לדעתך' לאחר החלת הזיכוי

Cloud 16.02.17

מזהה הבעיה התיאור
MGMT-3083 הרענון האוטומטי של היומנים של Node.js עמוס מדי בהודעות היומן
MGMT-3077 ממשק המשתמש יוצר חבילת שרת Proxy לא חוקית מ-WSDL שמשתמשת במרחב השמות שמוגדר כברירת מחדל
MGMT-1642 בתפקיד המשתמש בהתאמה אישית חסרה הרשאת 'קבל' לאפליקציות למפתחים

בעיות ידועות

בגרסה הזו קיימות הבעיות המוכרות הבאות.

מזהה הבעיה התיאור
APIRT-2978

הנתב לא מצליח להפעיל את Nginx או שהנתב לא פועל

אם נתב Edge לא מצליח להפעיל את Nginx או שלא פועל בכלל, כפי שמוצג בקובץ /opt/apigee/var/log/edge-router/logs/system.log, עליך למחוק את כל הקבצים בספרייה /opt/nginx/conf.d ולהפעיל מחדש את הנתב:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

מעבד ההודעות מבצע חיפוש DNS ב-IPv4 וב-IPv6

אם התקנתם והפעלתם את NSCD (Name Service Cache Daemon), ייתכן שתבחינו בכך שמעבדי הודעות מבצעים שני חיפושי DNS: אחד עבור IPv4 ואחד עבור IPv6.

כדי להשבית את חיפוש ה-DNS ב-IPv6:

  1. בכל צומת של מעבד ההודעות, עורכים את /etc/nscd.conf.
  2. מגדירים את המאפיין הבא:

    Enable-cache מארחים לא
PRC-1118

שגיאה בהפעלת הפקודה apigee-service apigee-postgresql pg-data-purge"

אם אתם מריצים את הפקודה "apigee-service apigee-postgresql pg-data-purge" ומופיעה שגיאה בפורמט:

שגיאה: חייב להיות הבעלים של הקשר

עורכים את /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge ומגדירים את המאפיין הבא ל-'apigee':

POSTGRES_USER=apigee
DOC-1687 עקב התנגשות ידועה של תלות בחבילות, סוכן Katello שמשמש בשרת לוויין 6 לא יותקן כראוי במארחים של Apigee Edge שמריצים את הדימון (daemon) Qpid.

מטענים ייעודיים (payloads) של JSON בסעיפי המדיניות של 'הקצאת הודעה', 'יתרונות מרכזיים של Java' ו-Raise Fault

כללי המדיניות 'הקצאת הודעה', 'יתרונות מרכזיים של Java' ו-'Upload Fault' מאפשרים ליצור תוכן של הודעות באמצעות הרכיב <Set><Payload>. בהודעות האלה אפשר לכלול משתנים שהערכים שלהם מאוכלסים באופן אוטומטי בזמן הריצה. לדוגמה, אם רוצים ליצור פלט של התאריך מכותרת ה-HTTP, אפשר להוסיף {message.header.date} להודעה.

אם פורמט ההודעה הוא JSON, היא תיראה כך:

{"The date is: " : "{message.header.date}"}

עם זאת, אפשר לראות שה-JSON שגוי. כדי לפתור את הבעיה, אפשר:

  • יוצאים מהסוגריים המסולסלים הפותחים באמצעות קו נטוי הפוך: 
    \{"The date is: " : "{message.header.date}"}
  • בהגדרות של רכיב המטען הייעודי (payload), צריך להשתמש במאפיינים variablePrefix ו-variableSuffix כדי לציין משתנה במטען ייעודי (payload) של JSON. לדוגמה:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

בגרסת Edge הבאה של תכונות בענן פרטי, תוכלו להשתמש בסוגריים מסולסלים למשתנים בהודעות JSON בלי בעיה. (APIRT-1160)

הנתב לא מצליח להפעיל את Nginx או שהנתב לא פועל

אם נתב Edge לא מצליח להפעיל את Nginx או שלא פועל בכלל, כפי שמוצג בקובץ /opt/apigee/var/log/edge-router/logs/system.log, עליך למחוק את כל הקבצים בספרייה /opt/nginx/conf.d ולהפעיל מחדש את הנתב:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
הקודם
4.16.05.01
הבא
4.16.01.08