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

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

בקטע הזה מתואר גרסה 4.19.01 של Edge for Private Cloud Feature Release.

סיכום הגרסה

בטבלה הבאה מפורטים השינויים בגרסה הזו:

תכונות חדשות

הגרסה הזו כוללת את התכונות החדשות הבאות:

‫○ השקת זמינות כללית (GA) של ממשק המשתמש של Edge
‫○ השקת זמינות כללית (GA) של מונטיזציה בממשק המשתמש של Edge
‫○ apigee-monit מוסיף שירותי תיקון עצמי וניטור
‫○ בממשק המשתמש של Edge יש מאפייני הגדרה חדשים של TLS
‫○ עכשיו אפשר ליצור, לערוך ולמחוק מארחים וירטואליים בממשק המשתמש של Edge
‫○ נוספה תמיכה ב-OpenAPI v3
‫○ נוספה תמיכה ב-RedHat Enterprise Linux‏ (RHEL) וב-CentOS 7.6
‫○ נוספה תמיכה ב-Oracle Linux 7.5

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

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

‫○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
   18.04.23.00 		‫○ Portal:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
הוצאה משימוש ללא
הפסקת תמיכה התמיכה בגרסה 4.17.09 של Apigee Edge for Private Cloud הופסקה (יצאה משימוש).

מידע נוסף זמין במאמר הוצאה משימוש, סגירה ושינויים ב-CPS ב-Apigee.
תיקוני באגים

הגרסה הזו כוללת את תיקוני הבאגים הבאים:

‫○ Zookeeper לא הופסק על ידי סקריפט הגיבוי (122694069)
‫○ נוסף דף נחיתה 'אין ארגונים' (120993451)
‫○ מחיקת דוחות בהתאמה אישית (120682369)
‫○ כרטיסיית מפה גיאוגרפית בגרסה החדשה של Edge (מספר 120681592)
‫○ אפשרויות Zookeeper JVM (מספר 120624977)
‫○ אירעו שגיאות לא מוגדרות בהסברים הקצרים (80187407)
‫○ יצירת שרתי proxy הפוכים באמצעות OpenAPI (מספר 79949124)
‫○ איפוס סיסמאות לא שולח קישורים (77515655)
‫○ כותרות שגויות לקישורים לאיפוס סיסמאות (72799769)
‫○ שימוש ב-WSDL ליצירת שרתי proxy של API (מספר 69550284)

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

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

‫○ פורמט קובץ המטא-נתונים להתקנה של apigee-sso‏ (135616498)
‫○ apigee-monit לא נתמך ב-Amazon Linux 1‏ (122370980)
‫○ הגיבוי של Message Processor לא מגבה את קבוצת הקבצים הנכונה (121095148)
‫○ טוקנים של סשנים לא עוברים ביטול (115278838)
‫○ פעולות Cassandra לא פועלות כשמופעלת אימות JMX‏ (113342838)
‫○ HEAD בקשות ליעדי Node.js נתקעות (79993247)
‫○ שמות מארחים לא נפתרים (79757554)
‫○ DataAccessExceptions בהגדרות של כמה מרכזי נתונים (76087166)
‫○ מדיניות MessageLogging כוללת מידע נוסף בהודעת היומן (68722102)
‫○ אי אפשר לאפס את הסיסמה של אדמין המערכת (65737520)

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

נתיבי שדרוג

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

מגרסה 4.18.05 שדרוג ישירות מגרסה 4.18.05 לגרסה 4.19.01
מגרסה 4.18.01 שדרוג ישירות מגרסה 4.18.01 לגרסה 4.19.01
מ-4.17.09 שדרוג ישירות מגרסה 4.17.09 לגרסה 4.19.01
מגרסה 4.17.05 שדרוג מגרסה 4.17.05 לגרסה 4.18.01, ואז שדרוג מגרסה 4.18.01 לגרסה 4.19.01
מגרסה 4.17.01 שדרוג מגרסה 4.17.01 לגרסה 4.18.01 →, ואז שדרוג מגרסה 4.18.01 לגרסה 4.19.01
החל מ-4.16.09 שדרוג מגרסה 4.16.09 לגרסה 4.18.01, ואז שדרוג מגרסה 4.18.01 לגרסה 4.19.01
מגרסה 4.16.05 שדרוג מגרסה 4.16.05 לגרסה 4.18.01, ואז שדרוג מגרסה 4.18.01 לגרסה 4.19.01
מגרסה 4.16.01 שדרוג מגרסה 4.16.01 לגרסה 4.18.01, ואז שדרוג מגרסה 4.18.01 לגרסה 4.19.01
מגרסה 4.15.0x שדרוג מגרסה 4.15.0x לגרסה 4.16.01, ואז שדרוג מגרסה 4.16.01 לגרסה 4.18.01, ואז שדרוג מגרסה 4.18.01 לגרסה 4.19.01

תכונות חדשות

בקטע הזה מפורטות התכונות החדשות בגרסה הזו. בנוסף, הגרסה הזו כוללת את כל התכונות בגרסאות של Edge UI,‏ Edge Management ו-Portal שמפורטות בגרסאות הכלולות.

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

גרסה זמינה לכלל המשתמשים (GA) של ממשק המשתמש של Edge

ממשק המשתמש של Apigee Edge הוא שירות ממשק המשתמש לניהול העדכני ביותר שלנו. בעבר, היא הייתה בגרסת בטא. ב-Apigee Edge for Private Cloud v4.19.01, ממשק המשתמש של Edge הוא חלק מהגרסה הכללית.

כדי להשתמש בממשק המשתמש של Edge, צריך להפעיל SAML ואז להתקין את ממשק המשתמש של Edge בצומת משלו.

מידע נוסף זמין במאמר בנושא ממשק המשתמש של Edge ל-Private Cloud.

גרסה זמינה לכלל המשתמשים (GA) של מונטיזציה בממשק המשתמש של Edge

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

עכשיו אפשר לנהל את כל המשימות שקשורות למונטיזציה ב-Apigee Edge for Private Cloud בממשק המשתמש החדש של Edge, כולל: המשימות הבאות:

ההודעה הזו היא הודעה רשמית על הוצאה משימוש של דוחות שונות במונטיזציה. מידע נוסף על הוצאה משימוש של Apigee

‫apigee-monit מוסיף שירותים של תיקון עצמי ומעקב

‫Apigee Edge for Private Cloud כולל עכשיו את apigee-monit, כלי שמבוסס על כלי השירות monit בקוד פתוח. ‫apigee-monit מבצע סקרים תקופתיים של שירותי Edge. אם שירות מסוים לא זמין, apigee-monit מנסה להפעיל אותו מחדש.

מידע על התקנה, הגדרה ושימוש ב-apigee-monit זמין במאמר תיקון עצמי באמצעות apigee-monit.

מאפייני הגדרה חדשים של TLS

ממשק המשתמש של Edge תומך במאפייני הגדרת TLS חדשים שבהם אפשר להשתמש כדי להגדיר את הדברים הבאים:

  • פרוטוקול TLS שמוגדר כברירת מחדל
  • רשימה של פרוטוקולי TLS נתמכים
  • אלגוריתמים נתמכים של TLS
  • הצפנות הנתמכות ב-TLS

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

יצירה, עריכה ומחיקה של מארחים וירטואליים בממשק המשתמש של Edge

הרחבנו את הפונקציונליות של השירות העצמי, ועכשיו אפשר ליצור, לערוך ולמחוק מארחים וירטואליים בדפדפן (רק בממשק המשתמש של Edge).

מידע נוסף זמין במאמר בנושא יצירת מארח וירטואלי באמצעות דפדפן.

נוספה תמיכה ב-OpenAPI v3

בגרסה הזו הוספנו תמיכה ביצירת שרת proxy באמצעות OpenAPI גרסה 3 (בממשק המשתמש של Edge בלבד).

תוכנות נתמכות

הגרסה הזו כוללת את השינויים הבאים בתוכנה הנתמכת:

הוספת תמיכה אין יותר תמיכה

בגרסה הזו נוספה תמיכה בפלטפורמות הבאות:

  • ‫Red Hat Enterprise Linux ‏ (RHEL) 7.6
  • ‫CentOS 7.6
  • Oracle Linux 7.6

הפלטפורמות הבאות כבר לא נתמכות בגרסה הזו:

  • ‫RHEL/CentOS/Oracle בגרסה 7.3
  • ‫RHEL/CentOS בגרסה 6.8
  • Oracle Linux 6.7

כאן אפשר לעיין ברשימה המלאה של הפלטפורמות הנתמכות.

תיקוני באגים

בקטע הזה מפורטים הבאגים ב-Private Cloud שתוקנו בגרסה הזו. בנוסף, הגרסה הזו כוללת את כל תיקוני הבאגים בגרסאות של Edge UI,‏ Edge Management ו-Portal שמוצגות בגרסאות כלולות.

מזהה הבעיה תיאור
122694069

Zookeeper לא הופסק על ידי סקריפט הגיבוי

לפני התיקון הזה, תהליך Zookeeper לא הופסק על ידי סקריפט הגיבוי.
120993451

נוסף דף נחיתה'אין ארגונים'

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

מחיקת דוחות בהתאמה אישית

המשתמשים לא יכלו למחוק דוחות בהתאמה אישית בגרסה החדשה של Edge.
120681592

הכרטיסייה 'מפה גיאוגרפית' בגרסה החדשה של Edge

כשמשתמשים ניווטו לכרטיסייה Geomap בגרסה החדשה של Edge, הגרסה החדשה של Edge הציגה שגיאה.
120624977

Zookeeper JVM options

הגדרת אפשרויות JVM באמצעות Code with Config עבור Zookeeper לא פעלה.
80187407

שגיאות לא מוגדרות הופיעו בתיאורי הכלים

כשהיה תרשים עם סדרת זמן אחת בלבד, הצגת תיאורי הכלים גרמה לשגיאות לא מוגדרות.
79949124

יצירת שרתי proxy הפוכים באמצעות OpenAPI

הכפתור Use OpenAPI לא פעל כשניסיתם ליצור שרתי proxy.
77515655

איפוס סיסמאות לא שולח קישורים

המשתמשים לא קיבלו אימיילים כשביקשו קישור לאיפוס הסיסמאות שלהם.
72799769

כותרות שגויות לקישורים לאיפוס סיסמה

גם אחרי שמשתמש הגדיר את המאפיין trustxforwarded לערך true, כותרות הבקשה שנוצרו לא השתמשו ב-HTTPS.
69550284

שימוש ב-WSDL ליצירת שרתי proxy ל-API

יצירת שרת proxy של API נכשלה כשנעשה שימוש בקובצי WSDL.

בעיות מוכרות

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

מזהה הבעיה תיאור
135616498

פורמט קובץ המטא-נתונים להתקנה של apigee-sso

כשמתקינים את apigee-sso ומשתמשים בקובץ metadata.xml במקום בכתובת URL, אם הקובץ לא כולל שורה חדשה (CRLF) בסוף הקובץ, הקובץ לא נקרא במלואו.

פתרון עקיף:

כדי לעקוף את הבעיה, אפשר לבצע אחת מהפעולות הבאות:

  • מוסיפים CRLF בסוף הקובץ metadata.xml

    או

  • שימוש במיקום שמבוסס על כתובת URL למטא-נתונים
122370980

‫apigee-monit לא נתמך ב-Amazon Linux 1

פתרון עקיף:

ללא.
121095148

גיבוי מעבד ההודעות לא מגבה את קבוצת הקבצים הנכונה

פתרון עקיף:

מריצים את הגיבוי פעם נוספת, והוא אמור לגבות את קבוצת הקבצים הנכונה.
115278838

טוקנים של סשנים לא בוטלו

אסימוני סשן לא עוברים פסילה בשרת כשהמשתמש לוחץ על הלחצן 'יציאה' ב-Apigee Edge.

פתרון עקיף:

שימוש בממשק החדש של Edge עם SAML.
113342838

פעולות של Cassandra לא פועלות כשהאימות של JMX מופעל

פתרון עקיף:

מוסיפים את שם המשתמש והסיסמה בכל פעם שמפעילים את הפקודה nodetool.
79993247

HEAD בקשות ליעדי Node.js נתקעות

בקשות HEAD ליעד Node.js עשויות להיתקע ולהשאיר חיבורים בהמתנה.

פתרון עקיף:

כדי לעקוף את הבעיה הזו, צריך להגדיר handler לבקשות HEAD כדי להחזיר במפורש תגובה ריקה.
79757554

שמות המארחים לא מפוענחים

אחרי התקנה או שדרוג של Edge for Private Cloud, יכול להיות ששמות המארחים לא יזוהו ככתובות שלהם.

פתרון עקיף:

כדי לפתור את הבעיה, מפעילים מחדש את רכיב Edge UI:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
76087166

DataAccessException בהגדרות של כמה מרכזי נתונים

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

DataAccessException: Error while accessing datastore;
Please retry later

התוצאה היא ששרת הניהול לא יופעל כי הוא ינסה להתחבר לצמתי Cassandra ב-dc-1 וב-dc-2. השגיאה DataAccessExceptions מתרחשת אם צומת Cassandra מושבת. יכול להיות שזה גם יגרום לשיבוש בתנועת הנתונים של ה-API, כשמעבדי ההודעות מדווחים על DataAccessExceptions בניסיון לאחזר KVM.

שימו לב: המצב הצפוי הוא ששרת הניהול לא יתחבר לרכיבי מאגר הנתונים באזורים שונים.

פתרון עקיף

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

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

כדי לבטל את הרישום של סוגי הצמתים האלה של Cassandra ולרשום אותם מחדש:

  1. מקבלים את מזהי ה-UUID של צמתי Cassandra באמצעות הפקודה curl הבאה: 
    curl -u ADMIN_EMAIL:ADMIN_PW \
  "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
  &type=CASSANDRA_NODE_TYPE"

    כאשר:

    • ‫ADMIN_EMAIL ו-ADMIN_PW הם פרטי הכניסה לחשבון Apigee שלכם.
    • ‫MS_IP ו-MS_PORT הם כתובת ה-IP ומספר היציאה של שרת הניהול.
    • ‫REGION הוא השם של מרכז הנתונים שבו נמצא שרת הניהול.
    • ‫GATEWAY_POD הוא שם ה-pod, שהוא כברירת מחדל gateway. יכול להיות ששיניתם את השם שלו למשהו אחר, לכן כדאי לבדוק את ההטמעה.
    • ‫CASSANDRA_NODE_TYPE הוא אחד מהערכים kms-datastore, dc-datastore ו-keyvaluemap-datastore.

    לדוגמה: 

    curl -u nickdanger@google.com:myP@$$w0rD
  "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    התשובה מבוססת על הפורמט הבא: 

    {
  "internalIP" : "POD_IP_ADDRESS",
  "isUp" : [true|false],
  "pod" : "GATEWAY_POD",
  "reachable" : [true|false],
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
    "uUID" : "POD_UUID"
}

    לדוגמה: 

    {
  "internalIP" : "192.168.1.11",
  "isUp" : false,
  "pod" : "gateway",
  "reachable" : false,
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : "dc-datastore",
  "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
}

    שימו לב לערכים של השדה uUID בתגובה. תשתמשו בהם כדי לבטל את הרישום של הצמתים.

  2. חוזרים על שלב 1 לכל סוג הצומת של Cassandra: ‏ kms-datastore,‏ dc-datastore וkeyvaluemap-datastore. חשוב לשים לב ל-UUID שמוחזר.
  3. מבטלים את הרישום של הצמתים באמצעות הפקודה הבאה: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    כאשר UUID הוא ה-UUID שמוחזר בתגובה של הפקודה הקודמת.

  4. חוזרים על שלב 3 לכל UUID שאספתם בשלבים 1 ו-2.
  5. מבצעים רישום מחדש של הצמתים באמצעות הפקודה הבאה: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
  "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
  Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
  region=REGION&pod=GATEWAY_POD" -H \
  'content-type: application/x-www-form-urlencoded' -X POST

שימו לב שהפעולות האלה רושמות ומבטלות את הרישום של צמתים מ-Zookeeper, ואין להן השפעה על אשכול Cassandra. מידע נוסף על הפקודות האלה זמין במאמר בנושא עדכון רישומים של מאגרי נתונים.
68722102

מדיניות MessageLogging שכוללת מידע נוסף בהודעת היומן

האלמנט FormatMessage של מדיניות MessageLogging שולט בפורמט של ההודעה שנרשמת ביומן. כשמשתמשים ב-FormatMessage=false, ההודעה שנרשמת ביומן לא אמורה לכלול מידע שנוצר על ידי Apigee. עם זאת, גם אם מגדירים את FormatMessage=false, הודעת היומן עדיין כוללת את הפרטים הבאים:

  • ציון העדיפות
  • חותמת הזמן

פתרון עקיף:

ללא.
65737520

איפוס הסיסמה של אדמין המערכת נכשל

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

פתרון עקיף:

מגדירים את הסיסמה בקובץ נתונים, ואז מעבירים אותו לנקודת הקצה /users ב-Management API. מידע נוסף זמין במאמר איפוס הסיסמה של אדמין המערכת.

השלב הבא

כדי להתחיל להשתמש ב-Edge for Private Cloud 4.19.01, אפשר להיעזר בקישורים הבאים:

התקנות חדשות:
סקירה כללית של התקנה חדשה
התקנות קיימות:
מסלולי שדרוג