דרישות לפורטל של שירותים למפתחים

Developer Services Portal גרסה 4.16.09

אלה דרישות החומרה והתוכנה להתקנה.

דרישות לגבי מסד נתונים של MySQL

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

אם אתם רוצים להתקין את שרת MySQL במערכת נפרדת, אתם צריכים להתקין את שרת MySQL במערכת הזו לפני שתפעילו את תוכנת ההתקנה של Developer Channel Services. צריך להתקין את MySQL בגרסה 5.0.15 ואילך.

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

המשתמש במסד הנתונים משמש את Developer Channel Services כדי להתחבר למסד הנתונים, וצריכות להיות לו ההרשאות הבאות: SELECT, ‏ INSERT, ‏ UPDATE, ‏ DELETE, ‏ CREATE, ‏ DROP, ‏ INDEX, ‏ ALTER, ‏ CREATE TEMPORARY TABLES, ‏ LOCK TABLES.

לדוגמה, כדי ליצור מסד נתונים בשם devportal ומשתמש בשם devportal:

1. מתקינים את MySQL Server במערכת.
2. מתחברים ל-MySQL כמשתמש Root באמצעות הפקודה:
   > mysql -u root -p
3. כשתתבקשו, תצטרכו להזין את הסיסמה שבחרתם למכונה.
4. בשורת הפקודה mysql>, מזינים את הפקודה הבאה כדי ליצור את המשתמש devportal:
   mysql>create user 'devportal'@'localhost' identified by 'devportal';
   mysql> grant all privileges on *.* to 'devportal'@'localhost';
   mysql> flush privileges;
   mysql> quit
5. בשורת הפקודה של המערכת, יוצרים את מסד הנתונים devportal:
   > mysqladmin -u devportal -p create devportal
   
   מזינים את הסיסמה של devportal.
6. מתחברים ל-MySQL ונותנים גישה ל-devportal מכתובת ה-IP של שרת הפורטל:
   mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';
   
   כאשר portalIP הוא כתובת ה-IP של שרת הפורטל, ו-devportalPW הוא הסיסמה של המשתמש devportal.
7. עורכים את הקובץ ‎ /etc/my.cnf כדי להגדיר את bind-address לכתובת ה-IP של שרת MySQL.
8. מפעילים מחדש את MySQL:
   > /etc/init.d/mysqld restart
9. מוודאים שיציאה 3306 פתוחה בשרת MySQL. התהליך הזה תלוי במערכת ההפעלה. לדוגמה, ב-Linux משתמשים בפקודה:
   ‎> /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT‎

כשמתקינים את Developer Channel Services, צריך לציין שלא רוצים להתקין את MySQL Server באופן מקומי. לאחר מכן תתבקשו להזין את כתובת ה-IP, שם המשתמש ושם מסד הנתונים של מסד הנתונים המרוחק.

דרישות ל-Red Hat Enterprise Linux (RHEL)

ל-RHEL יש דרישות נוספות בגלל שצריך מינוי כדי לגשת להורדות תוכנה מ-Red Hat. השרת צריך להיות מסוגל להתחבר לאינטרנט כדי להוריד קובצי RPM באמצעות yum. אם משתמשים ב-RHEL, השרת צריך להיות רשום ב-Red Hat Network‏ (RHN) ובערוץ האופציונלי של השרת.

הדרישות של Red Hat נבדקות במהלך ההתקנה, ואם RHEL לא רשום, מנהל ההתקנה של הפורטל יציג בקשה. אם כבר יש לכם פרטי כניסה ל-Red Hat, אתם יכולים להשתמש בפקודה הבאה כדי לרשום את RHEL לפני שאתם מתחילים בתהליך ההתקנה:

> subscription-manager register --username=my_username --password=my_password --auto-attach 

מחליפים את my_username ואת my_password בפרטי הכניסה שלכם ל-Red Hat.

אם יש לכם גרסת ניסיון של RHEL, אתם יכולים לקבל רישיון לגרסת ניסיון ל-30 יום. מידע נוסף זמין בכתובת https://access.redhat.com/solutions/32790.

דרישות SMTP

כברירת מחדל, הפורטל שולח אימייל באמצעות הפונקציה mail()‎ של PHP. ‫PHP מנסה לשלוח אימייל באמצעות sendmail במערכת המקומית, שאפשר להגדיר בקובץ php.ini של PHP.

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

דרישות נוספות

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

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

ל-Developer Channel Services יש ממשק יחיד עם שרת הניהול של Apigee דרך API בארכיטקטורת REST, כדי לאחסן ולאחזר מידע על האפליקציות של המשתמש. ‫Developer Channel Services צריכים להתחבר לשרת הניהול דרך HTTP או HTTPS, בהתאם להתקנה.

המידע שנדרש לפני שמתחילים בהתקנה

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

1. איזו פלטפורמה אתם מגדירים: Red Hat או CentOS? אם זו התקנה של Red Hat, המכונה צריכה להיות רשומה ב-Red Hat Network כדי להוריד קובצי RPM.
2. אתם מתכננים להתקין את MySQL במחשב המקומי? בחלק מההתקנות של HA, צריך ש-MySQL יהיה במכונה אחרת מזו שמציגה את דפי האינטרנט של הפורטל. במקרה כזה, אל תתקינו את MySQL באופן מקומי. אם אתם רוצים התקנה פשוטה שבה הכול נמצא באותו מחשב, התקינו את MySQL באופן מקומי.
3. אם אתם מתכוונים לגשת לשרת MySQL מרוחק, תצטרכו את שם המארח, היציאה, שם מסד הנתונים, שם המשתמש והסיסמה של שרת MySQL המרוחק. לפני שמתחילים את ההתקנה, צריך להגדיר את שרת ה-MySQL המרוחק.
4. מהו שם הדומיין שמוגדר במלואו של שרת האינטרנט? (המידע הזה יתווסף אל ‎ /etc/hosts.) הערך צריך להיות כתובת IP או שם מארח, כמו portalserver.example.com. ערך ברירת המחדל הוא localhost.
5. האם להשתמש בהגדרת ברירת המחדל של Apigee למארח הווירטואלי של Apache? מארח וירטואלי אחד נוצר עם שם המארח שציינתם בשלב 7 שלמעלה.
6. יש שלושה פרטי מידע שמאפשרים לפורטל לתקשר עם שרת הניהול של Apigee Edge. המידע הזה כולל:
   1. כתובת ה-URL של נקודת הקצה ל-API של Apigee Management: שם מארח או כתובת IP. זוהי נקודת הקצה של REST שאליה מתבצעות כל הקריאות ליצירת אפליקציות ולרישום מפתחים למפתחות של אפליקציות. נקודת הקצה שמוגדרת כברירת מחדל היא https://api.enterprise.apigee.com/v1.
      
      בהתקנה של Edge for Private Cloud, כתובת ה-URL היא בפורמט:
      http://EdgeIp:8080/v1
      
      או:
      https://EdgeIp:SSLport/v1
      
      כאשר EdgeIp היא כתובת ה-IP של שרת הניהול של Edge, ו-SSLport היא יציאת ה-SSL של Management API של Edge. לדוגמה, 8443.
   2. שם הארגון ב-Apigee: יש קשר בין הפורטלים לבין הארגונים ב-Apigee Edge. אתם תגדירו את הארגון שמוגדר כברירת מחדל כשתגדירו את נקודת הקצה של Management API. ערך ברירת המחדל הוא my-org.
   3. שם משתמש וסיסמה לנקודת הקצה של Management API: הקריאות מהפורטל ל-Edge צריכות להתבצע על ידי אדמין בארגון.
      
      שם המשתמש והסיסמה האלה מיועדים לאדמין בארגון שלך, וצריך להשתמש בהם רק כדי להתחבר ל-Edge מהפורטל. לדוגמה, אם תציינו את פרטי הכניסה של משתמש, והמשתמש הזה יימחק ב-Edge, הפורטל לא יוכל יותר להתחבר ל-Edge. לכן, צריך ליצור אדמין בארגון רק בשביל החיבור הזה.
      
      לדוגמה:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd