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 כלולה בגרסה שלכם.

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

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

פרטים נוספים והוראות זמינים במסמכי התיעוד של 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) זמין עכשיו בגרסה 4.16.05.bootstrap_4.16.05.sh
  • כבר לא צריך לציין את uname:pword כדי להוריד את bootstrap_4.16.05.sh. 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)

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 של פרוקסי API, ומאפשרים לציין שם של פרוקסי API, שם של ProxyEndpoint ספציפי בפרוקסי API, או פשוט את Base Path למשאב פרוקסי API מקומי (למשל, ‎/v1/myresource). ממשק המשתמש של עורך ה-proxy מספק גם את האפשרויות האלה כשמוסיפים או מעדכנים TargetEndpoint.

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

מידע נוסף זמין במאמר בנושא שרשור של פרוקסי 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