עבודה עם הפנתאון

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X.
מידע

ב-Apigee משתמשים ב-Pantheon, שירות לניהול אתרים, לאירוח גרסאות מבוססות-ענן של פורטל השירותים למפתחים. Pantheon תוכננה לפעול עם Drupal כדי לאפשר לכם לפתח, לבדוק ולפרסם את הפורטל בסביבה מאובטחת. השירות לניהול אתרים של Pantheon זמין ללקוחות שזקוקים לאירוח ולפיתוח ברחבי העולם.

הקטעים הבאים מתארים כיצד להשתמש ב-Pantheon כדי לפתח ולנהל את הפורטל שלכם.

גישה למרכז השליטה של הפנתאון

כש-Apigee שולח לך את כתובת ה-URL של הפורטל שלך, מתקבלת גם כתובת ה-URL של מרכז השליטה של הפנתאון: https://dashboard.getpantheon.com/.

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

ממרכז הבקרה אפשר לגשת לאתר, להגדיר את החשבון ולבצע פעולות נוספות.

בוחרים את התמונה של האתר (לדוגמה apigeedocs) כדי לפתוח את מרכז הבקרה של האתר:

ניהול הסביבות שלך

במרכז השליטה של הפנתאון מופיעות שלוש סביבות בחלק העליון של הדף: Dev , Test ו-Live. כל אחד מהם מתואר בטבלה הבאה.

סביבה

תיאור

פיתוח

סביבת Dev מקושרת למאגר Git. כל שינוי שתבצעו ב-Git יופיע מיד בסביבת ה-Dev.

כתובת ה-URL של האתר הזה היא בפורמט הבא, כאשר org_name הוא שם הארגון שלך:

http://dev-{org_name}.devportal.apigee.io/

בדיקה

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

כתובת ה-URL של האתר הזה היא בפורמט הבא, כאשר org_name הוא שם הארגון שלך:

http://test-{org_name}.devportal.apigee.io/

פעיל

הסביבה Live היא סביבת הייצור שלכם, שאתם מעניקים ללקוחות גישה אליה.

כתובת ה-URL של האתר הזה היא בפורמט הבא, כאשר org_name הוא שם הארגון שלך:

http://live-{org_name}.devportal.apigee.io/

פיתוח תוכן הפורטל שלך

הקטעים הבאים מתארים כיצד לפתח את תוכן הפורטל שלכם.

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

אם רוצים...

אתם יכולים

מידע נוסף

שינוי המראה והסגנון של האתר

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

למידע נוסף, ראו התאמה אישית של המראה:

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

למידע נוסף, אפשר לקרוא את המאמר התאמה אישית של העיצוב

שינוי ההתנהגות של הפונקציונליות של האתר

בסיסי – משתמשים בהגדרות האדמין בפורטל כדי לשנות או להגדיר את התנהגות האתר.

ניתן לעיין בתיעוד של Apigee החל מכאן

מתקדם – יוצרים מודול מותאם אישית כדי לשנות התנהגות כלשהי של האתר.

למידע על יצירת מודולים מותאמים אישית במסמכי התיעוד של Drupal

סקירה כללית על מאגר הנתונים של Git

מאגר Git של קוד ה-Drupal שלך מכיל את כל קוד הפורטל שלך, ומאורגן לפי המבנה הבא.

הערה: יש לשנות את התוכן רק בתוך הספרייה /sites/all. אם משנים תוכן שלא נמצא בספרייה /sites/all, יכולות להיות בעיות במהלך השדרוג לגרסאות חדשות וייתכן שתיתקלו בהתנגשויות מיזוג כשתבדקו את השינויים ב-Git.

תיקייה במאגר Git

התיאור

/profiles/apigee

מודולים ועיצובים ב-Apigee מתוחזקים, כולל:

  • /profiles/apigee/modules/contrib: מודולים של Drupal לתורמים שמתוחזקים על ידי Apigee
  • /profiles/apigee/themes/contrib: עיצובים של גרפים ב-Drupal המתוחזקים על ידי Apigee
  • /profiles/apigee/modules/custom: מודולים מותאמים אישית שנוצרו על ידי Apigee
  • /profiles/apigee/themes/custom: עיצובים מותאמים אישית שנוצרו על ידי Apigee

הערה: אל תשנו את התוכן בספרייה /profiles/apigee. אם תשדרגו לגרסאות חדשות, ייתכן שתיתקלו בהתנגשויות מיזוג כשתבדקו את השינויים ב-Git. לשיטות המומלצות של Drupal, אפשר לעיין במאמר אף פעם לא לפרוץ לליבה.

/sites/all

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

הערה: יש לשנות את התוכן רק בתוך הספרייה /sites/all.

גישה לקוד שלך

כדי לגשת למאגר הקודים ב-Git, צריך לבצע את המשימות שמתוארות בקטעים הבאים:

כדאי לעיין גם בקטע איך אפשר לגשת לקוד המקור של פורטל המפתחים של Drupal 7?

הפעלת גישת SSH לשרת שלכם

כדי לנהל את קוד ה-Drupal שלך באמצעות Git, עליך להפעיל את SSH כדי לקבל גישה לשרת שלך. לשם כך, עליך להעלות מפתח SSH ל-Pantheon.

כדי להפעיל את גישת SSH לשרת שלכם:

  1. מתחברים לפנתאון בכתובת https://dashboard.getpantheon.com/.
  2. במרכז השליטה, בוחרים באפשרות חשבון.
  3. בוחרים באפשרות SSH Keys (מפתחות SSH) בתפריט שמימין.
  4. מוסיפים את המפתח ובוחרים באפשרות הוספת מפתח.
    לקבלת עזרה, לוחצים על הקישור מידע על יצירת מפתח SSH.

גישה למאגר הקודים ב-Git

הערה: סקירה כללית של מבנה מאגר הנתונים ב-Git זמינה בדף סקירה כללית על מאגר Git.

כדי לגשת למאגר הקודים ב-Git:

  1. נכנסים למרכז השליטה של הפנתאון.
  2. בדף הראשי של Google Sites, בוחרים את סמל הפורטל.
  3. כתובת ה-URL של מאגר Git מופיעה בדף שמשמאל למצב החיבור, כמו באיור הקודם.
  4. מעתיקים את כתובת ה-URL של מאגר Git ומשכפלים אותה לסביבת הפיתוח המקומית באמצעות הפקודה:
    > git clone gitURL sitename
    לדוגמה:
    > git clone ssh://codeserver.dev.12@codeserver.dev.12.drush.in:2222.git/reposport.in:2222/git/reposport.in:2222.git/reposport.

כל שינוי בקוד שדוחפים למאגר Git מופיע באופן מיידי בסביבה Dev של הפורטל.

פריסת קוד בסביבות של הפורטל

כדי לקודד לסביבות הפורטל שלכם:

  1. שולחים את עדכוני הקוד ל-Git, שמעדכן באופן מיידי את סביבת Dev.
  2. צריך להתחבר לפנתאון ולבחור את האתר.
  3. בוחרים את הסביבה Dev.
  4. בוחרים באפשרות </>Code (קוד) בתפריט השמאלי כדי לראות הודעה לגבי שינוי הקוד ב-Commit Log:
  5. בוחרים את הסביבה בדיקה בראש הדף.
    1. אם עדיין לא העליתם את Dev (פיתוח) לבדיקה, תוצג לכם בקשה לעשות זאת.
    2. אם כבר יש לכם סביבת בדיקה, תופיע הודעה שמציינת שיש התחייבות מ-Dev שמוכנה לפריסה:
  6. אם כבר דחיתם אתר לסביבת Live, אפשר לסמן את התיבה השלישית כדי להעתיק את מסד הנתונים הפעיל ואת כל הקבצים שהועלו על ידי המפתחים לצורך בדיקה מ-Live. האפשרות הזו שימושית כשרוצים לבדוק את השינויים בקוד בהשוואה לנתונים העדכניים ביותר שזמינים ב-Live.
  7. לוחצים על הלחצן פריסת קוד מהפיתוח.
  8. בודקים את הפורטל בסביבה בדיקה.
  9. מבצעים תיקוני קוד בסביבת Dev ודוחפים שוב את הקבצים למצב בדיקה כדי לבדוק אותם.
  10. בסיום הבדיקה, בוחרים את הסביבה Live בראש הדף.
    1. אם עדיין לא העליתם את התכונה בדיקה למצב שידור חי, תתבקשו לעשות זאת עכשיו.
    2. אם כבר יש לכם סביבת Live, תופיע הודעה שמציינת שיש התחייבות מבדיקה שמוכנה לפריסה. פורסים את השינויים האלה בדיוק כמו שפרסתם אותם ב-בדיקה שב-Dev. בסיום הבדיקה, מעבירים את הקוד לסביבה Live.

מידע נוסף:

הוספה של מודולים ועיצובים מותאמים אישית

אפשר להרחיב את הפונקציונליות של הפורטל על ידי הוספת מודולים ועיצובים בהתאמה אישית לתיקיות המפורטות בטבלה הבאה.

הערה: יש לשנות את התוכן רק בתוך הספרייה /sites/all. אם משנים תוכן מחוץ לספרייה /sites/all, עשויות להתרחש התנגשויות מיזוג ובודקים את השינויים ב-Git.

מודול/עיצוב תיקייה במאגר Git מידע נוסף (מסמכי תיעוד של Drupal)
מודולים מותאמים אישית sites/all/modules/custom יצירת מודולים מותאמים אישית
עיצובים מותאמים אישית sites/all/themes התאמה אישית של העיצוב
עיצוב של Drupal 7

אחרי שמוסיפים את המודול או העיצוב בהתאמה אישית בסביבת Dev, אפשר לפרוס אותו ב-בדיקה לצורך בדיקה, ואז בסביבה Live לייצור, כמתואר במאמר פריסת קוד לסביבות הפורטל.

עקיפת מודולים ועיצובים של פרופיל Drupal

המודולים והעיצובים בספריות הבאות מבטלים את המודולים והעיצובים של פרופיל Drupal שמתוחזקים ומופצים על ידי Apigee ב-/profiles/apigee. סקירה כללית על מאגר Git

לדוגמה, יכול להיות שתרצו לשנות מודול בהפצת Apigee Drupal בתרחישים הבאים:

  • כשרוצים להשתמש בגרסה אחרת של מודול מסוים.
  • ברצונך ליישם עדכון אבטחה לפני הגרסה המתוכננת הבאה של Apigee.
מודול/עיצוב תיקייה במאגר Git מידע נוסף (מסמכי תיעוד של Drupal)
מודולים שנוספו ל-Drupal

sites/all/modules/contrib

הערה: מודולים שמאוחסנים בכל מקום שהוא ב-/sites/all/modules יבטלו את המודולים של ההפצה של Apigee Drupal.

מודולים שנוספו

הערה: מודולים שנוספו על ידי Drupal בספרייה הזו מבטלים מודולים מקבילים שמתוחזקים והופצו על ידי Apigee ב-/profiles/apigee/modules. כדי להשתמש במודולים של פרופיל Drupal מתוחזקים ב-Apigee, צריך להסיר את כל המודולים הכפולים שהוספת לתיקייה הזו.

עיצובים שנוספו ל-Drupal sites/all/themes עיצובים שנוספו

הערה: עיצובים שנוספו על ידי Drupal בספרייה הזו מבטלים מודולים מקבילים שתוחזקו והופצו על ידי Apigee ב-/profiles/apigee/themes. אם ברצונך להשתמש בעיצובי הפרופיל המתוחזקים של Apigee, צריך להסיר את המודולים הכפולים שהוספת לתיקייה הזו.

מידע על הקובץ settings.php

settings.php Drupal מחויב למאגר Git של Apigee Drupal Developer Portal במעלה הזרם (Git). אם רוצים לבצע שינויים בקובץ sites/default/settings.php, אין לערוך אותו ישירות. במקום זאת, צריך ליצור קובץ בשם sites/default/settings.local.php ולהציב בו את הקוד בהתאמה אישית. sites/default/settings.local.php נכלל בקובץ settings.php.

לדוגמה, כשמגדירים דומיין מותאם אישית לאתר פעיל בהתאם להוראות של Pantheon, במקום לשנות את קובץ ה-settings.php ישירות, צריך להוסיף את העדכונים הנדרשים ב-sites/default/settings.local.php.

אבטחת הפורטל

אתרי הפורטל שמשויכים לסביבות Dev, בדיקה ו-Live נגישים כברירת מחדל. המשמעות היא שכל מי שיש לו את כתובת ה-URL של האתר יוכל לגשת אליו, אבל ייתכן שהוא לא יוכל לרשום חשבון או להתחבר לאתר. מידע נוסף על שליטה ברישום משתמשים זמין במאמר הוספה וניהול של חשבונות משתמשים.

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

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

אם אתם רוצים להפעיל TLS/SSL באתר שלכם, ראו שימוש ב-TLS בפורטל.

החלת עדכון של Apigee לפורטל שלך

כש-Apigee מפרסמת גרסה חדשה של הפורטל, מופיעה הודעה במרכז השליטה של הפנתאון.

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

כדי להחיל עדכון:

  1. מתחברים ל-Pantheon בכתובת https://dashboard.getpantheon.com/ ובוחרים באתר שלכם.
  2. בוחרים את הסביבה Dev.
  3. בחר בתפריט </>קוד שמימין. אם יש עדכונים זמינים ל-Apigee, הם יוצגו.
  4. מחילים את העדכון:
    1. מסמנים את התיבה Run update.php לאחר שליפת קוד.
    2. אם האפשרות זמינה, מסמנים את התיבה ניקוי המטמון לאחר שליפת הקוד.
    3. לוחצים על הלחצן פריסת קוד.
  5. אחרי שהעדכון מסתיים, צריך לבחור את האפשרות סטטוס בתפריט שמימין ללוח הבקרה.
  6. באזור Status (סטטוס) של הסביבה, יכול להיות שתופיע שגיאה בעדכון של מסד הנתונים, כפי שמוצג כאן:

    אם השגיאה הזו מופיעה בסביבה כלשהי, עליכם לעדכן את מסד הנתונים באופן ידני:

    1. אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
    2. בפינה הימנית העליונה של הפורטל, לוחצים על סמל דף הבית > הרצת עדכונים.
    3. פועלים לפי ההוראות לעדכון מסד הנתונים.
  7. מעבירים את השינויים בקוד לסביבת הבדיקה ואז לוחצים על Live, כפי שמתואר למעלה.

העברת התכונות המותאמות אישית

אם מוסיפים לפורטל קוד או תכונות בהתאמה אישית, צריך להחליט איך לתחזק אותם ואיך להעביר אותם מסביבות Dev (פיתוח) ל-בדיקה ל-Live (שידור חי).

לגבי קוד במאגר Git, תוכלו להשתמש בתהליך שמתואר במאמר פריסת קוד לסביבות הפורטל כדי להעביר את הקוד מ-Dev ל-Test ל-Live.

אם יצרת הגדרות אישיות, צריך להשתמש באחת מהשיטות הבאות כדי להעביר אותן:

שיטה תיאור
ייצוא ההגדרות לקוד יש הרבה הגדרות נפוצות שאפשר לייצא לקוד באמצעות המודול 'תכונות'. לדוגמה, תצוגות, חלוניות, מטמון של תמונות וכו'.
הטמעת הפונקציה hook_update_N() Drupal מנהלת שינויים במסד הנתונים ובתצורה באמצעות הפונקציה hook_update_N().

אם יש לכם מודול מותאם אישית, אפשר:

  • כדי לעבד את השינויים, צריך להוסיף את הפונקציות hook_update_N() לקובץ .install של המודול.
  • פורסים את השינויים האלה יחד עם הקוד.
  • מריצים את הפקודה update.php כדי להעביר את השינויים בסביבות Stage וב-Prod.

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

הגדרת דומיין מותאם אישית

שמות הדומיינים ש-Apigee מספקים לפורטל ברירת מחדל ל-apigee.io, כפי שמתואר במאמר ניהול הסביבות, וייתכן שהם לא מה שאתם רוצים לחשוף ללקוחות.

תוכניות של פורטלים בתשלום יכולות להגדיר שם דומיין מותאם אישית עבור הפורטל (לא ניתן ליצור דומיין מותאם אישית בחשבונות של מפתחים או בחינם). כדי להשתמש בדומיין מותאם אישית, צריך ליצור רשומת CNAME ב-DNS ולהפנות את הדומיין אל edge.apigee.getpantheon.com.

לדוגמה, כדי להגדיר את הדומיין המותאם אישית עבור חברה בשם Mytech:

  1. קובעים את הגדרת ה-DNS הבאה:
    developer.mytech.com. 3600 IN CNAME edge.apigee.getpantheon.com
    ייתכן שיחלפו עד 48 שעות לפני שהשינוי הזה ב-DNS ייכנס לתוקף בכל מכשירי הלקוח.
  2. כדי להוסיף את הדומיין למרכז השליטה של הפנתאון עבור סביבת Live בלבד, משתמשים ברשומה בתפריט Domains / SSL בצד שמאל של מרכז השליטה.
    ברוב המקרים, מגדירים DNS רק לסביבה Live, ולא לסביבה Dev ו-בדיקה. לא מומלץ להשתמש בסביבות Dev או test בסביבת הייצור.

למידע נוסף, ניתן לעיין בתיעוד של הפנתאון כאן.

הוספת מנהלי מערכת של הפורטל

כשיתקבל אימייל מ-Apigee על כך שהפורטל שלך מוכן, Apigee כבר הגדירה רשימה של מנהלי הפורטל. אפשר להציג את הרשימה בלחיצה על הקישור Team בפינה הימנית העליונה של מרכז הבקרה של האתר.

כדי להוסיף מנהלי מערכת, אפשר לעיין במאמר יצירת משתמשים עם הרשאת אדמין.

גיבוי הפורטל

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

למידע נוסף, ראו כלי הגיבויים במסמכי הפנתיאון.

הרשמה לקבלת עדכוני סטטוס

אפשר להירשם לגרסה ואת עדכוני הסטטוס של Apigee בכתובת status.apigee.com. עליך ללחוץ על הרשמה לקבלת עדכונים, להזין את הפרטים ליצירת קשר כמו כתובת האימייל, כאשר תוצג בקשה לכך, וללחוץ על הרשמה. בדף הניהול של ההתראות באימייל, מוודאים שהאפשרות פורטל למפתחים מסומנת, משנים הגדרות אחרות של ההתראות לפי הצורך ולוחצים על עדכון ההעדפות.

בכתובת http://status.getpantheon.com אפשר להירשם לעדכוני סטטוס ולדוחות אירועים של Pantheon, למשל במקרה של הפסקה זמנית בשירות. כדי להירשם, לוחצים על הרשמה לעדכונים.