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

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

ביום שלישי, 31 במאי 2016, השקנו גרסה חדשה של Apigee Edge לענן פרטי.

מאז הגרסה הקודמת של Edge למהדורת פיצ'ר של ענן פרטי (4.16.01), הגרסאות הבאות בוצעו ונכללים בגרסת תכונה זו:

• ענן: 16.02.17, 16.03.02, 16.03.09 (ממשק משתמש), 16.03.16 (ממשק משתמש), 16.03.23 (ממשק משתמש), 16.03.30

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

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

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

לפרטים נוספים והוראות, ראו את מסמכי התיעוד של Edge לענן פרטי.

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

עכשיו אפשר לגשת למדריך Edge להתקנה ותפעול של ענן פרטי בגרסה 4.18.01.

עדכוני תוכנה

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

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

התקנה, שדרוג, רולבק

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

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

ניהול

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

• אימות התקנה – הכלי apigee-validate שמשמש לבדיקת הענן הפרטי של Edge להפעיל את ההתקנה משרת הניהול. בעבר, היה צורך להריץ את הסקריפט במעבד ההודעות. ראו בדיקת התקנה.
• שם האזור – האזור יכול להיות כל שם. בגרסאות הקודמות השם היה בצורה "dc-#", כאשר # היה ערך של מספר שלם.
• Gateway Pods – לקבוצות של השערים יכולים להיות כל שם. בגרסאות קודמות, צריך היה לקרוא לקפסולה בתור "gateway".
• ניהול מבוסס-סקריפט – A כלי שורת הפקודה apigee-adminapi.sh החדש מאפשר לבצע את אותן פעולות ביצוע משימות תצורה של Edge באמצעות קריאות ל-Edge management API. צפייה באמצעות apigee-adminapi.sh.
• הגדרת SSL שקט של מארח וירטואלי – כשיוצרים ארגון או אפשר עכשיו להעביר מאפיינים כדי להגדיר SSL במארח וירטואלי. מידע נוסף זמין במאמר הצטרפות לארגון.

שירותי API

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

קידומת באורך קבוע לרישום הודעות ב-syslog (Cloud 16.03.30)

למדיניות של רישום הודעות יש רכיב <FormatMessage> חדש ב- את התצורה של Syslog. על ידי הגדרת <FormatMessage>true</FormatMessage>, הודעות Syslog להתחיל במספר קבוע של תווים, מה שמאפשר לך לסנן את הנתונים שנוספו באמצעות Apigee. לקבלת מידע נוסף מידע, ראו הודעה מדיניות הרישום ביומן. (APIRT-1398)

תו כללי לחיפוש בנתיב Base Proxy ל-API (ממשק משתמש של Cloud 16.03.09)

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

שרשורי שרת proxy ל-API (ממשק משתמש של Cloud 16.03.02, Cloud 16.03.09)

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

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

שרשור של שרתי proxy זמין גם במדיניות בנושא יתרונות מרכזיים של שירות.

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

הבאגים תוקנו

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

Edge ל-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 ב- הקצאה של כללי מדיניות בנושא שליחת הודעות, יתרונות מרכזיים ב-Java והעלאת שגיאות

כללי המדיניות 'הקצאת הודעה', 'הסבר על 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 להשקת תכונה של ענן פרטי, אפשר להשתמש בסוגריים מסולסלים בהודעות JSON בלי בעיות. (APIRT-1160)

הנתב לא מצליח להפעיל Nginx או הפעלת הנתב נכשלה

אם נתב הקצה לא מצליח להפעיל את 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