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

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

ביום שלישי, 31 במאי 2016, השקנו גרסה חדשה של Apigee Edge for Private Cloud.

מאז הגרסה הקודמת של Edge for Private Cloud (‏4.16.01), יצאו הגרסאות הבאות והן כלולות בגרסה הזו:

במאמר מידע על מספור הגרסאות מוסבר איך אפשר לדעת אם גרסה ספציפית של Edge for Private Cloud כוללת גרסה מסוימת של Cloud.

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

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

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

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

מעכשיו יש לך גישה למדריך ההתקנה והתפעול של Edge for Private Cloud בגרסה 4.18.01.

עדכוני תוכנה

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

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

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

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

  • תהליך חדש לעדכון מגרסה 4.16.01 – בגרסה הזו, כלי השירות apigee-migrate מוחלף בכלי השירות update.sh כדי לעדכן את ההתקנה מגרסה 4.16.01 לגרסה 4.16.05. עדכון Apigee Edge מגרסה 4.16.01 לגרסה 4.16.05
  • Bootstrap
    • ‫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 Rollback Process.
  • ‫setup.sh ו-update.sh יכולים לכתוב את קובץ היומן אל /tmp – כברירת מחדל, כלי השירות setup.sh ו-update.sh כותבים את פרטי היומן אל /opt/apigee/var/log/apigee-setup. אם למשתמש שמריץ את כלי השירות אין גישה לספרייה הזו, היומן נכתב לספרייה /tmp. אם למשתמש אין גישה ל-/tmp, כלי השירות ייכשל.
  • תהליך העדכון של API BaaS – בגרסה 4.16.01, היה צריך להתקין מחדש את API BaaS כדי להעביר אותו. כלי השירות החדש update.sh תומך בעדכון API BaaS במקום. עדכון Apigee Edge מגרסה 4.16.01 לגרסה 4.16.05

ניהול

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

  • אימות ההתקנה – עכשיו אפשר להריץ את כלי השירות apigee-validate שמשמש לבדיקת ההתקנה של Edge Private Cloud משרת הניהול. בעבר, היה צריך להריץ את הסקריפט במעבד ההודעות. איך בודקים את ההתקנה
  • שם האזור – האזור יכול להיות כל שם. בגרסאות קודמות, השם היה בצורה dc-#, כאשר # היה ערך שלם.
  • Gateway pods – ל-Gateway pods יכול להיות כל שם. בגרסאות קודמות, היה צריך לקרוא ל-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)

Wildcard in API proxy Base Path (Cloud 16.03.09 UI)

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

שרשור של proxy ל-API‏ (Cloud 16.03.02, Cloud 16.03.09 UI)

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

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

אפשר גם להשתמש בשרשור של שרתי proxy במדיניות Service Callout.

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

באגים שתוקנו

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

‫Edge for Private Cloud 4.16.05

מזהה הבעיה תיאור
PRC-770 ‫16.01 installer fails to register Postgres standby server in axgroup
PRC-758 משתמש עם תפקיד משתמש יכול לערוך דוחות בהתאמה אישית
PRC-883 העדכון בשרת Postgres עם תצורת master-standby נכשל

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 מופיעות השגיאות "No rings configured; Cannot initialize cps service"
AXAPP-2345 בעיה בדוחות בהתאמה אישית של כרטיסי מוצר AX ללקוחות שלא משתמשים ב-CPS
AXAPP-2302 בסיכום היומי של Apigee Analytics מוצג אפס בקטע developer adoption (הטמעה בקרב מפתחים)
APIRT-2750 שיעור גבוה של כשלים בתנועה בארגון מסוים
APIRT-2516 שגיאות בזמן ריצה בהפניות חיצוניות של JavaScript מציינות מספרי שורות שגויים
APIRT-2508 שגיאת יציאה כשמתקשרים להאזנה מהירה בתוך קריאה חוזרת (callback) של כספת
APIRT-2336 בעיה ב-Gzip ב-Node.js
APIRT-1975 הגדרות המסיכה לא פועלות עבור message.content

Cloud 16.03.16 UI

מזהה הבעיה תיאור
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 מפתח שמשלם מראש עם יתרה אפסית מעלה NullpointerException כשמחילים זיכוי

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 hosts no
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 שמשמש ב-Satellite Server 6 לא יותקן בצורה תקינה במארחי Apigee Edge שמריצים את Qpid daemon.

מטענים ייעודיים (payloads) של JSON במדיניות Assign Message,‏ Java Callout ו-Raise Fault

הכללים Assign Message,‏ Java Callout ו-Raise 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 for Private Cloud, תוכלו להשתמש בסוגריים מסולסלים למשתנים בהודעות 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