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

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

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

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

• Cloud: 16.02.17, 16.03.02, 16.03.09 (UI), 16.03.16 (UI), 16.03.23 (UI), 16.03.30

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

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

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

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

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

עכשיו אפשר לגשת למדריך ההתקנה והתפעול של Edge for Private Cloud בכתובת Version 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 משרת הניהול. בעבר, היה צריך להריץ את הסקריפט במעבד ההודעות. מידע נוסף מופיע במאמר בנושא בדיקת ההתקנה.
• ‫Region name (שם האזור) – האזור יכול להיות כל שם. בגרסאות קודמות, השם היה בצורה 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)

למדיניות Message Logging (רישום הודעות ביומן) יש אלמנט חדש, <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)

שרשור של 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

Cloud 16.03.30

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

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

Cloud 16.03.02

Cloud 16.02.17

בעיות מוכרות

בגרסה הזו יש את הבעיות הידועות הבאות.

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

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

המדיניות בנושא הקצאת הודעה, קריאה ל-Java והעלאת תקלה מאפשרת ליצור תוכן של הודעה באמצעות רכיב <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