עבודה עם Acquia

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

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

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

גישה לממשק של Acquia Cloud

אחרי שתגדירו את חשבון Acquia Cloud, תוכלו לגשת לפורטל דרך הממשק של Acquia Cloud בכתובת https://cloud.acquia.com/.

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

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

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

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

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

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

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

סביבה	תיאור	כתובת ה-URL שמוגדרת כברירת מחדל
פיתוח	פיתוח תכונות חדשות והתאמה אישית של הפורטל.	http://{application-name}xxxxxx.devcloud.acquia-sites.com/ כאשר application-name הוא שם האפליקציה ו-xxxxxx הוא מחרוזת תווים ייחודית שמשמשת להבחנה בין Dev ל-Stage.
במה	בודקים את הקוד העדכני לפני שמעבירים אותו לסביבת הייצור.	http://{application-name}yyyyyy.devcloud.acquia-sites.com/ כאשר application-name הוא שם האפליקציה ו-yyyyyy הוא מחרוזת תווים ייחודית שמשמשת להבחנה בין Dev ל-Stage.
ייצור	פרסום הפורטל שלך לייצור (זמין).	http://{application-name}.devcloud.acquia-sites.com/ כאשר application-name הוא שם האפליקציה. הערה: אפשר לקרוא גם את המאמר הגדרת דומיין מותאם אישית.

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

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

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

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

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

אם רוצים...	אתם יכולים	מידע נוסף
שינוי המראה והסגנון של האתר	בסיסית – משתמשים בתפריט מראה באתר הפורטל כדי לבצע שינויים, כמו שינוי הלוגו וצבעי האתר.	למידע נוסף, ראו התאמה אישית של המראה
	מתקדם - כדי לבצע שינויים במראה ובסגנון המלאים של האתר, צריך להרחיב את העיצוב עם יכולת התגובה של 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, צריך לבצע את המשימות שמתוארות בקטעים הבאים:

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

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

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

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

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

1. מתחברים לממשק של Acquia Accounts בכתובת https://accounts.acquia.com.
2. לוחצים על Credentials.
3. אם מתבקשים, מזינים מחדש את הסיסמה כדי לאמת את הזהות.
4. בקטע 'מפתחות SSH' לוחצים על Add SSH key (הוספת מפתח SSH).
5. הזן את המידע הבא:

   שדה	תיאור
   כינוי	הכינוי של מפתח ה-SSH. הכינוי יכול להכיל תווים אלפאנומריים וקווים תחתונים.
   מפתח ציבורי	מפתח ציבורי. למידע על יצירת מפתח ציבורי SSH, תוכלו לקרוא את המאמר יצירת מפתח ציבורי SSH במסמכי התיעוד של Acquia Cloud.

6. לוחצים על Add key.

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

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

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

1. מתחברים לממשק של Acquia Cloud בכתובת https://cloud.acquia.com/.
2. בדף Apps (אפליקציות), לוחצים על Manage (ניהול) כדי להציג את פרטי הפורטל.
3. לוחצים על פרטי האפליקציה בסרגל הניווט.

   

4. מעתיקים את פקודת השכפול בתיבת הדו-שיח 'פרטי האפליקציה'.
5. משכפלים את מאגר Git לסביבה המקומית על ידי הרצת אחת מהפקודות הבאות של Git:

   כדי לשכפל את מאגר Git וליצור הסתעפות חדשה:

   > git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

   כדי לשכפל את מאגר Git מההסתעפות מאסטר:

   > git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

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

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

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

במאמר עבודה עם אתרים ב-Aquia Cloud תוכלו לקרוא את המאמר עבודה עם אתרים ב-Aquia Cloud, שבו מוסבר איך לפרוס, להחליף או להחזיר קוד בסביבת פורטל, להעביר את הקוד בין סביבות או לקבל מידע נוסף על מבנה המאגר ותהליך העבודה המומלץ. כשפורסים קוד חדש בסביבה, צריך להריץ את update.php כדי לבצע את העדכונים הנדרשים למסד הנתונים.

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

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

הערה: יש לשנות את התוכן רק בתוך הספרייה /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, צריך להסיר את המודולים הכפולים שהוספת לתיקייה הזו.

הפעלת SSL

כדי לאפשר גישה מאובטחת לאתר שלך באמצעות HTTPS, עליך להפעיל SSL.

כדי להפעיל SSL:

1. צריך לקבל אישור SSL מרשות אישורים (CA) או מספק אישור SSL. למידע נוסף, ראו הפעלת SSL.
2. מעלים את אישור ה-SSL בדף SSL בממשק של Acquia Cloud. למידע נוסף, ראו ניהול אישורי SSL.

אבטחה של סביבת הייצור

כשיוצרים אפליקציה, ניתן לנהל באופן חופשי את סביבת הייצור ולהפיץ את השינויים מסביבות הפיתוח וה-Staging. אחרי פרסום התוכן מומלץ לנעול את סביבת הייצור כדי למנוע עדכונים לא מורשים או מקריים של התוכן. מידע נוסף זמין במאמר שימוש במצב ייצור להגנה על אפליקציות בזמן אמת במסמכי התיעוד של Acquia Cloud.

כדי לאבטח את סביבת הייצור:

1. מתחברים לממשק של Acquia Cloud בכתובת https://cloud.acquia.com/.
2. בדף Apps (אפליקציות), לוחצים על Manage (ניהול) כדי להציג את פרטי האתר בפורטל.
3. לוחצים על ייצור כדי להציג את פרטי סביבת הייצור.
4. לוחצים על מצב ייצור בסרגל הניווט.
5. לוחצים על הפעלה כדי להפעיל את מצב הייצור.

מתבצעת החלה של עדכוני מודולים ועיצובים בפורטל

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

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

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

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

מודולים או עיצובים	תיאור
מודולים של Apigee Edge	Apigee מחילה עדכונים באופן אוטומטי על סביבת Dev בלבד. אחרי בדיקת העדכונים, מעבירים אותם מסביבות Dev ל-Stage לסביבות Prod, כמו שמתואר במאמר פריסת קוד לסביבות הפורטל.
עיצוב עם יכולת תגובה של Apigee	Apigee מחילה עדכונים באופן אוטומטי על סביבת Dev בלבד. אחרי בדיקת העדכונים, מעבירים אותם מסביבות Dev ל-Stage לסביבות Prod, כמו שמתואר במאמר פריסת קוד לסביבות הפורטל.
מודולים של Drupal ומודולים שנתרמו	Apigee מחילה עדכונים באופן אוטומטי על סביבת Dev בלבד. אחרי בדיקת העדכונים, מעבירים אותם מסביבות Dev ל-Stage לסביבות Prod, כמו שמתואר במאמר פריסת קוד לסביבות הפורטל.
מודולים ועיצובים מותאמים אישית	אם הוספתם מודולים ועיצובים מותאמים אישית לפורטל, כפי שמתואר בקטע הוספה של מודולים ועיצובים בהתאמה אישית, צריך להתקין את העדכונים באופן ידני. מורידים את הגרסה האחרונה לספרייה המקומית באופן ידני או באמצעות Drush. בשלב הבא, מבצעים את העדכונים למאגר Git, מתחייבים ומעבירים אותם למאגר. אחרי בדיקת העדכונים, מעבירים אותם מסביבות Dev ל-Stage לסביבות Prod, כמו שמתואר במאמר פריסת קוד לסביבות הפורטל.

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

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

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

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

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

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

כפי שצוין בקטע ניהול הסביבות, שמות הדומיינים המוגדרים כברירת מחדל לסביבות הפורטל מסתיימים ב-acquia-sites.com. מומלץ לספק שם דומיין מותאם אישית שמותאם אישית ומשקף בצורה טובה יותר את מטרת האתר. לדוגמה, חלופה פופולרית היא:

https://developers.mycompany.com

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

1. הוספת הדומיין שלך לסביבת אתר הפורטל. אפשר לקרוא את המאמר ניהול דומיינים במסמכי התיעוד של Acquia Cloud.
2. כדי להגדיר את הדומיין המותאם אישית אצל ספק ה-DNS, צריך להפנות את רשומת ה-DNS של שם הדומיין לכתובת ה-IP הציבורית (לא לדומיין acquia-sites.com). ראו הפניית רשומות DNS לכתובות ה-IP הציבוריות שלכם במסמכי התיעוד של Acquia Cloud.

   הערה: אין להגדיר את רשומת ה-CNAME של שם הדומיין לדומיין acquia-sites.com. הפעולה הזו עלולה לגרום לבעיות זמן אחזור או לזמן השבתה של אתר הפורטל.

מעקב אחר הפורטל שלך באמצעות Acquia Insight

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

גיבוי הפורטל

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

רכיב	פרטי הגיבוי	מידע נוסף ב-Acquia Cloud Docs
קוד	הקוד מתוחזק על ידי מערכת לניהול גרסאות ומתויג בכל פעם שאתם מתחייבים. אפשר לסנכרן תג ספציפי או לחזור להשתמש בו מתי שרוצים.	גיבויים לקוד
מסד נתונים	גיבויים יומיים מבוצעים ונשמרים במשך שלושה ימים. מתזמנים גיבויים אוטומטיים וגיבויים על פי דרישה. צילומי המצב של כל הנתונים שמקורם באסון פנימי מתועדים בכל שעה.	גיבויים של מסדי נתונים שימוש במשימות מתוזמנות כדי לתחזק את האפליקציה
Files	צריך לבצע גיבויים ידניים או לתזמן משימת cron.	גיבויים שימוש במשימות מתוזמנות כדי לתחזק את האפליקציה
אפליקציה מלאה	מבצעים גיבוי ידני באמצעות Drush.	גיבויים מלאים של האפליקציות שימוש במשימות מתוזמנות כדי לתחזק את האפליקציה
מערכת הקבצים Drupal	יש לבצע גיבויים ידניים באחת מהאפשרויות הבאות: אפשר להעתיק את הקבצים באמצעות לקוח FTP או כלי שורת הפקודה (rsync ו-scp). אפשר ליצור ארכיון דחוס באמצעות Drush. הערה: המודול Backup and Migrate לא נתמך ב-Acquia Cloud. מידע נוסף זמין במאמר המודול 'גיבוי והעברה' לא נתמך ב-Acquia Cloud.	גיבוי במערכת הקבצים של Drupal שימוש במשימות מתוזמנות כדי לתחזק את האפליקציה

הצגת התראות על פעילות

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

כדי להציג את רשימת ההתראות:

1. מתחברים לממשק של Acquia Cloud בכתובת https://cloud.acquia.com/.
2. בדף Apps (אפליקציות), לוחצים על Manage (ניהול) כדי להציג את פרטי האתר בפורטל.
3. כדי להציג את ההתראות האחרונות, צריך ללחוץ על סמל הפעמון בפינה השמאלית העליונה של סרגל הניווט.

   

4. לוחצים על החץ שליד ההתראה כדי להציג מידע נוסף על הפעילות.

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

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

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

1. עוברים אל הדף 'סטטוס רכישה'.
2. לוחצים על הרשמה לקבלת עדכונים.
3. בוחרים את השיטה שבה רוצים להשתמש כדי לקבל עדכונים (אימייל, SMS וכו').
4. בדף 'התראות', בוחרים את המוצרים שרוצים לקבל לגביהם עדכוני סטטוס. לדוגמה, Acquia Cloud Enterprise.
5. לוחצים על עדכון ההעדפות.