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

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

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

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

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

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

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

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

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

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

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

סביבה	תיאור
פיתוח	סביבת ה-Dev מחוברת למאגר Git. כלשהו שינויים שאתם מעבירים ב-Git ל-Git מופיעים מיד את הסביבה Dev. כתובת ה-URL של האתר הזה מופיעה בפורמט הבא, כאשר org_name הוא שם הארגון: http://dev-{org_name}.devportal.apigee.io/
בדיקה	סביבת Test מיועדת לבדיקת הקוד העדכני ביותר באמצעות עותק של נתונים מהסביבה Live. בסביבה הזו שבו בודקים שינויים בקוד לפני שמעבירים אותו את הסביבה השידור החי. כתובת ה-URL של האתר הזה מופיעה בפורמט הבא, כאשר org_name הוא שם הארגון: http://test-{org_name}.devportal.apigee.io/
פעיל	הסביבה Live היא סביבת הייצור שלך שאתה מנגיש ללקוחות שלך. כתובת ה-URL של האתר הזה מופיעה בפורמט הבא, כאשר org_name הוא שם הארגון: http://live-{org_name}.devportal.apigee.io/

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

בסעיפים הבאים מוסבר איך לפתח את התוכן שלכם בפורטל.

• סקירה כללית של מאגר Git
• גישה לקוד
• פריסת קוד בפורטל סביבות
• הוספת מודולים ועיצובים מותאמים אישית
• ביטול מודולים של פרופיל Drupal וגם עיצובים

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

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

סקירה כללית של מאגר Git

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

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

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

גישה לקוד

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

• הפעלה של גישת SSH לשרת
• גישה למאגר הקודים דרך Git

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

הפעלת גישת SSH לשרת שלך

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

כדי להפעיל גישת 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 שכפול gitURL שם אתר
   לדוגמה:
   > שכפול git ssh://codeserver.dev.12@codeserver.dev.12.drush.in:2222/~/repository.git devportal

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

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

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

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

מידע נוסף:

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

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

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

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

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

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

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

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

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

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

מודול/עיצוב	תיקייה במאגר של Git	מידע נוסף (מסמכי התיעוד של Drrupal)
מודולים של Drupal שנוספו	sites/all/modules/contrib הערה: מודולים שמאוחסנים בכל מקום שמתחת ל-/sites/all/modules יבטלו את מודולי ההפצה של Apigee Drupal.	מודולים שנוספו הערה: מודולים של Drupal שנוספו בספרייה הזו מבטלים מודולים מקבילים. מתוחזקים ומופצים על ידי Apigee ב-/profiles/apigee/modules. אם ברצונך להשתמש ב-Apigee, צריך להסיר את כל המודולים הכפולים שהוספת לתיקייה הזו מתוחזקים מודולים של פרופיל Drupal.
עיצובים שנוספו ב-Drupal	sites/all/themes	עיצובים שנוספו הערה: עיצובים של Drupal שנוספו בספרייה הזו מבטלים מודולים מקבילים מתוחזק ומופץ על ידי Apigee ב-/profiles/apigee/themes. מסירים מודולים כפולים נוספה לתיקייה הזו אם אתם רוצים להשתמש בעיצובי הפרופיל המתוחזקים של Apigee.

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

ה-Drupal settings.php מחויב למאגר Git של פורטל המפתחים של Apigee Drupal. כדי לבצע שינויים בקובץ 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, Test וגם כברירת מחדל, סביבות פעילות נגישות לציבור. כלומר, כל מי שיש לו כתובת ה-URL של האתר יכולה לגשת אליו, למרות שייתכן שהוא לא יכול לרשום חשבון או להתחבר אל באתר. מידע נוסף לגבי שליטה ברישום המשתמשים זמין במאמר הוספה וניהול של משתמשים חשבונות Google.

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

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

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

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

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

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

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

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

   

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

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

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

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

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

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

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

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

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

שמות הדומיינים ש-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. משתמשים ברשומת התפריט Domains / SSL בצד שמאל של למרכז השליטה כדי להוסיף את הדומיין הזה ללוח הבקרה של הפנתיאון עבור בסביבת Live בלבד.
   ברוב המקרים, מגדירים DNS רק לסביבה הפעילה, ולא בשביל Dev ו-Test. לא מומלץ להשתמש בה הסביבות Dev או Test בסביבת הייצור.

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

הוספת אדמינים של הפורטל

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

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

גיבוי הפורטל

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

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

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

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

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