אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info
החל מ-31 במאי 2020, Apigee לא תמשיך לתמוך באירוח של פורטלים למפתחים שמבוססים על Drupal 7 (D7P). לפני כן, החל מ-31 במאי 2019, לקוחות יצטרכו להקצות בעצמם כל פורטל חדש שמבוסס על Drupal.
אילו שינויים מתבצעים?
באפריל 2019 הכרזנו על השקת צוותים וקהלים של מפתחים בפורטל המפתחים המשולב של Apigee. במאי 2019 הודענו על השלמת ההכנות לייצור של פורטלים מבוססי Drupal 8 (D8P), שמספקים חלופה חדשה לפורטל המשולב המנוהל על ידי Apigee, וניהול הפורטלים האלה מתבצע על ידי הלקוחות. הפורטלים האלה כוללים את SmartDocs החדש. במקביל להכרזה על D8P, הודענו על סיום האירוח של D7P בעוד 12 חודשים, ועל כך שסקריפטים להתקנה ולשדרוג של D7P בענן פרטי יוסרו במהדורה 20.06.
למה האירוח הממומן על ידי Apigee בפורטלים למפתחים שמבוססים על Drupal 7 מסתיים?
אירוח בחסות Apigee ל-D7P יסתיים במאי 2020 משתי סיבות:
- הפורטלים המשולבים של Apigee הפכו לאפשרות מושכת ללקוחות, עם תכונות מתקדמות ועלות כוללת נמוכה יותר לבעלות.
- Drupal 8 מייצג את הדרך העתידית למי שרוצה להישאר ב-Drupal. המאמץ של המעבר מ-D7P ל-D8P הוא לא פשוט, אבל D8P מציע נתיב טוב יותר לכל לקוח שמעדיף פורטל למפתחים בניהול עצמי.
מה עליי לעשות?
לקוחות Apigee D7P צריכים להעריך את החלופות הזמינות, ליצור קשר ישיר עם ספק אירוח מועדף, כמו Pantheon או Acquia, או לבחון אפשרויות אירוח אחרות.
אילו אפשרויות כדאי לשקול?
לקוחות Cloud שמשתמשים ב-D7P יכולים לבחור באחת משלוש האפשרויות הבאות:
- מעבר לפורטלים המשולבים של Apigee.
- עוברים ל-Drupal 8.
- להישאר ב-Drupal 7 ולקחת על עצמכם את האחריות על אירוח האתר עד 31 במאי 2020.
לקוחות ענן פרטי שמשתמשים ב-D7P יכולים לבחור באחת משתי האפשרויות הבאות:
- עוברים ל-Drupal 8.
- בינתיים, כדאי להישאר ב-Drupal 7.
בהמשך מפורט מידע נוסף על כל אחת מהאפשרויות האלה.
אפשרות 1: מעבר לפורטל משולב של Apigee
למי כדאי לשקול את האפשרות הזו?
ספקי API שהשתמשו ב-Drupal 7 עם כמות מינימלית של התאמה אישית, או ספקים שמעדיפים פתרון 'הכול-באחד' שמתמקד בהגדרה עם עלות כוללת נמוכה יותר לבעלות.
פורטל המפתחים שמשולב ישירות ב-Apigee Edge כולל קטלוג API חזק ומערכת ניהול תוכן מבוססת Markdown עם כלים חזקים לניהול קהלים. כדי לבדוק אם הפורטל המשולב מתאים לתוכנית ה-API שלכם, תוכלו לפנות לנציג החשבון שלכם ב-Apigee.
במאמר העברת פורטל Drupal 7 לפורטל המשולב מוסבר איך לתכנן ולבצע את ההעברה של נכסי הפורטל מ-Drupal 7 לפורטל המשולב.
אפשרות 2: העברה אל Drupal 8
למי כדאי לשקול את האפשרות הזו?
ספקי API שהשתמשו בפונקציונליות של Drupal 7 בשילוב עם רמה גבוהה של התאמה אישית והשקעה בעיצוב חוויית משתמש ספציפית למפתחים.
בגלל ההבדלים המשמעותיים בין Drupal 7 ל-Drupal 8, כמו מנוע העיבוד של הדפים, יצירת התאמות אישיות דומות עשויה לדרוש כמות משמעותית של עבודה בהתאמה אישית. אם אתם צופים שתצטרכו להיעזר במומחים ל-Drupal 8, נציג החשבון שלכם ב-Apigee יוכל להמליץ לכם על שותפי פיתוח מומחים ב-Drupal. Apigee לא מספקת אירוח של D8P, אבל ל-Pantheon ול-Acquia יש ניסיון באירוח D8P ללקוחות Apigee.
אפשרות 3: להישאר ב-Drupal 7
למי כדאי לשקול את האפשרות הזו?
ספקי API שכבר משתמשים ב-Drupal 7 ופשוט רוצים יותר זמן לקבל החלטה.
בפרויקט Drupal 7 פורסמו לוחות זמנים לתמיכה לטווח ארוך (LTS) עד שנת 2021. ההודעה הזו לגבי אירוח לא משפיעה על התמיכה במודולים שמשתלבים עם Drupal 7 ב-Apigee Edge. עם זאת, חשוב לדעת שלקוחות בענן שרוצים להמשיך להשתמש ב-Drupal 7 חייבים לקחת אחריות ישירה על החשבון אצל ספק האירוח שלהם עד 31 במאי 2020.
איך מייצאים את הנתונים (לקוחות בענן)?
כדי לייצא את נתוני Drupal, אפשר לעיין בתהליך הייצוא של Pantheon או של Acquia.
מה יקרה אם לא אעשה את הפעולות הנדרשות?
אחרי 31 במאי 2020, D7P לא יהיה זמין לך וללקוחות שלך. לא תוכלו לנהל או לפתח ב-D7P, והלקוחות שלכם לא יוכלו להתחבר לפורטל D7P. כל פורטלים ה-D7P שמתארחים ב-Apigee יוצאו משימוש אחרי 31 במאי 2020.
למי אפשר לפנות לקבלת מידע נוסף או עזרה?
כדי לקבל פרטים נוספים על סיום האירוח של D7P, יש לפתוח כרטיס בפורטל התמיכה של Apigee עם שורת הנושא 'Drupal 7-based Developer Portal - hosting'.
האם יש כלים או תמיכה שיעזרו בהעברה של D7P ל-D8P?
Apigee לא מספקת תמיכה ישירה ב-Drupal, אבל נציג החשבון שלכם ב-Apigee יכול לקשר אתכם למומחים ב-Drupal שיכולים לעזור בהעברה ובפיתוח מותאם אישית.
האם יש כלים או תמיכה שיעזרו בהעברת D7P לפורטלים משולבים?
במאמר העברת פורטל Drupal 7 לפורטל המשולב מוסבר איך לתכנן ולבצע את ההעברה של נכסי הפורטל מ-Drupal 7 לפורטל המשולב.
אין כלים זמינים להעברה מ-Drupal לפורטל המנוהל על ידי Apigee, אבל יכול להיות ש-Apigee תוכל לעזור לכם בהעברה. המועמדים הטובים ביותר הם אלה שלא השקיעו הרבה בפיתוח מותאם אישית שעשוי להיות קשה להעביר, כמו תהליכי עבודה ספציפיים או כלים לאישור. לקבלת מידע נוסף, אפשר לפנות לנציג של חשבון Apigee.
אילו שינויים בוצעו ב-SmartDocs?
בקטעים הבאים מתוארים השינויים שבוצעו ב-SmartDocs החדשים ב-Drupal 8 בהשוואה ל-Drupal 7.
מה ההבדל בין התכונה החדשה של SmartDocs לבין הגרסה שמבוססת על Drupal 7?
יכול להיות שאתם מכירים את SmartDocs שנעשה בהם שימוש בפורטלים למפתחים של Drupal 7. איך משתמשים ב-SmartDocs כדי לתעד ממשקי API
SmartDocs ב-Drupal 8 כולל הרבה מהתכונות שציפיתם למצוא במסמכי עזרה של ממשקי API, והוא פועל עכשיו ישירות ממפרט OpenAPI. למידע נוסף, ראו תיעוד ממשקי ה-API.
האם יש תמיכה במפרט OpenAPI 3.0.x ב-SmartDocs?
מפרט OpenAPI 3.0.x נתמך על ידי SmartDocs החדשים שזמינים בפורטל של Drupal 8. בעתיד נוסיף תמיכה משופרת בתכונות החדשות של המפרט.
אילו סוגי אימות נתמכים ב-SmartDocs?
החלונית 'ניסיון של ממשק ה-API הזה' ב-SmartDocs פועלת עם נקודות קצה לא מאובטחות או עם נקודות קצה מאובטחות באמצעות אימות בסיסי, אימות באמצעות מפתח API או אימות OAuth, בהתאם לשיטת האבטחה שמוגדרת במפרט OpenAPI. ב-OAuth יש תמיכה בתהליכים הבאים: קוד הרשאה, מרומז, סיסמה ופרטי כניסה של לקוח.
האם SmartDocs היא האפשרות היחידה לתיעוד API?
SmartDocs הוא הפתרון של Apigee ליצירת מסמכי API שמבוססים על מפרט OpenAPI, אבל ב-Apigee מבינים שטוב שיש אפשרויות. בפורטלים של Drupal 8, המודול API Catalog תומך בפתרונות נוספים לעיבוד, כמו הפורמט של השדה ב-Swagger UI.