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

פורטל השירותים למפתחים גרסה 4.16.09

בהמשך מפורטות דרישות החומרה והתוכנה להתקנה.

חומרה

דרישה

מערכת הפעלה

הנחיות ההתקנה האלה וקבצי ההתקנה שסופקו נבדקו במערכות ההפעלה שמפורטות כאן: https://apigee.com/docs/api-services/reference/supported-software

RAM

‎1 GB

דיסק קשיח

‎10 GB

ממשק רשת

נדרש חיבור פעיל לאינטרנט.

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

לדוגמה, בקשה לכתובת https://drupal.org/ מחזירה קוד סטטוס HTTP‏ 301 ומפנה לכתובת https://www.drupal.org/.

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

בהתקנות של SAP, אם הסביבה שלכם מוגדרת לבקשות HTTPS יוצאות בשרת proxy, שרת ה-proxy צריך לתמוך ב-TLSv1.0. ב-OpenSSL 0.9.8 אין תמיכה ב-TLSv1.1 או ב-TLSv1.2, רק ב-TLSv1.0.

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

אם בוחרים להתקין את שרת MySQL באותה מכונה שבה מותקנים Developer Channel Services, הטופולוגיה של מכונה אחת, תוכנת ההתקנה של Developer Channel Services מבקשת להזין את שם מסד הנתונים ואת משתמש מסד הנתונים, ולאחר מכן מתקינה את שרת 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 במערכת.
  2. מתחברים ל-MySQL כמשתמש ברמה הבסיסית (root) באמצעות הפקודה:
    > mysql -u root -p
  3. מזינים את הסיסמה של root כשתופיע בקשה לעשות זאת.
  4. בהודעה mysql>, מזינים את הפקודה הבאה כדי ליצור את המשתמש המפתח:
    mysql>create user 'devportal'@'localhost' שמזוהה על ידי 'devportal';
    mysql> העניק את כל ההרשאות בדומיין *.* ל-'devportal'@'localhost';
    mysql> Flushקיים;
    mysql>
  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. השרת חייב להיות מסוגל להתחבר לאינטרנט כדי להוריד הכנסה לאלף צפיות דרך יאמי. אם משתמשים ב-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.

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

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

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

ל-Developer Channel Services יש ממשק יחיד עם שרת הניהול של Apigee באמצעות API ל-REST, כדי לאחסן ולשלוף מידע על האפליקציות של המשתמש. לשירותים למפתחים נדרשת אפשרות להתחבר לשרת הניהול באמצעות 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 של נקודת הקצה של Apigee Management API: זה יכול להיות שם מארח או כתובת 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 של Edge management API. לדוגמה, 8443.
    2. שם הארגון ב-Apigee: יש קשר בין פורטלים לבין ארגוני Apigee Edge. כשתגדירו את נקודת הקצה של ממשק ה-API לניהול, צריך להגדיר את ארגון ברירת המחדל. ערך ברירת המחדל הוא my-org.
    3. שם משתמש וסיסמה לנקודת הקצה של ממשק ה-API לניהול: רק אדמין בארגון יכול לבצע את הקריאות מהפורטל ל-Edge.

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

      לדוגמה:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd