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

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

בקטע הזה מוסבר על גרסה 4.19.01 של מהדורת התכונות של Edge for Private Cloud.

סיכום הגרסה

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

תכונות חדשות

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

‫○ השקת זמינות כללית (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, התרחשו הגרסאות הבאות והן כלולות בגרסה הזו:

‫○ 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)
○ כרטיסיית Geomap בגרסה החדשה של 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 targets נתקעות (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 UI

ממשק המשתמש של 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, של Edge Management ושל Portal שמופיעות בגרסאות הכלולות.

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

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

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

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

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

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

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

הכרטיסייה Geomap בגרסה החדשה של 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

יצירת ה-API Proxy נכשלה כשנעשה שימוש ב-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:

/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, אפשר להיעזר בקישורים הבאים:

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