כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של
Apigee X. מידע
החל מ-31 במאי 2020, Apigee לא תיתן יותר חסות לאירוח של פורטלים למפתחים שמבוססים על Drupal 7 (D7P). לפני כן, החל מ-31 במאי 2019, לקוחות יצטרכו להקצות בעצמם כל פורטל חדש שמבוסס על Drupal.
אילו שינויים מתבצעים?
באפריל 2019 הודענו על השקת צוותי מפתחים וקהלים עבור הפורטל המשולב למפתחים של Apigee. במאי 2019 הודענו על מוכנות הייצור של Drupal 8-based Portal (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, או לשקול אפשרויות אירוח אחרות.
מה האפשרויות שכדאי לשקול?
ללקוחות ענן שמשתמשים ב-D7P יש שלוש אפשרויות:
- עוברים לפורטלים המשולבים של Apigee.
- מעבר ל-Drupal 8.
- נשארים ב-Drupal 7 ומקבלים את אחריות האירוח עד 31 במאי 2020.
ללקוחות ענן פרטי שמשתמשים ב-D7P יש שתי אפשרויות:
- מעבר ל-Drupal 8.
- אני רוצה להישאר ב-Drupal 7 בינתיים.
כל אחת מהאפשרויות האלה מתוארת בהרחבה בהמשך.
אפשרות ראשונה: מעבר לפורטל משולב של Apigee
למי כדאי לשקול את האפשרות הזו?
ספקי API שמשתמשים ב-Drupal 7 עם כמות מינימלית של התאמה אישית, או כאלה שמעדיפים פתרון כוללני שמבוסס יותר על הגדרות ועלות בעלות כוללת נמוכה יותר.
פורטל המפתחים המשולב ישירות ב-Apigee Edge כולל קטלוג API מתקדם ומערכת ניהול תוכן מושכת המבוססת על Markdown, עם כלים חזקים לניהול קהלים. כדי לבדוק אם הפורטל המשולב יכול להתאים לתוכנית ה-API שלכם, פנו לאיש הקשר האחראי לחשבון Apigee.
הנחיות לתכנון ולביצוע של ההעברה של נכסי פורטל Drupal 7 לפורטל המשולב מפורטות במאמר העברה של פורטל Drupal 7 לפורטל המשולב.
אפשרות שנייה: מעבר אל 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 – Host Portal".
האם יש כלים או תמיכה זמינים שיעזרו לכם להעביר D7P ל-D8P?
אין ב-Apigee תמיכה ישירה ב-Drupal, אבל הנציג שלך לחשבון Apigee יכול לקשר אותך למומחים של Drupal שיכולים לסייע במיגרציה ובפיתוח בהתאמה אישית.
האם יש כלים או תמיכה זמינים שיעזרו לכם להעביר D7P לפורטלים משולבים?
הנחיות לתכנון ולביצוע של ההעברה של נכסי פורטל Drupal 7 לפורטל המשולב מפורטות במאמר העברה של פורטל Drupal 7 לפורטל המשולב.
אין כלים זמינים להעברה מ-Drupal לפורטל המנוהל על ידי Apigee, אך ייתכן ש-Apigee יוכל לעזור לך בהעברה. המועמדים הכי טובים הם אלה שלא השקיעו מאמצים רבים בפיתוח מותאם אישית שייתכן שיועבר בצורה לא טובה, למשל תהליכי עבודה ספציפיים או כלי אישור. למידע נוסף, אפשר לפנות לאיש הקשר האחראי לחשבון Apigee.
אילו שינויים בוצעו ב-SmartDocs?
בקטעים הבאים מתוארים השינויים שבוצעו בגרסה החדשה של SmartDocs ב-Drupal 8, בהשוואה לגרסה 7 של Drupal.
מה ההבדל בין התכונה החדשה SmartDocs לבין הגרסה מבוססת-Drupal 7?
ייתכן שאתם מכירים את SmartDocs שבו נעשה שימוש בפורטלים למפתחים של Drupal 7. למידע נוסף, ראו שימוש ב-SmartDocs לתיעוד ממשקי API.
SmartDocs ב-Drupal 8 מספק רבות מהתכונות המוכרות להן במסמכי התיעוד של ממשק ה-API, והן פועלות כעת ישירות ממפרט OpenAPI. מידע נוסף זמין במאמר תיעוד ממשקי ה-API.
האם OpenAPI Specification 3.0.x נתמך עם SmartDocs?
OpenAPI Specification 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 Field Formatter.