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

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

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

חומרה

דרישות

מערכת הפעלה

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

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

מנהל ההתקנה של Developer Channel Services דורש ששרת MySQL יכיל מסד נתונים עם סכימת מסד נתונים ריקה. מנהל ההתקנה של 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. כשמתבקשים, מזינים את הסיסמה של הרמה הבסיסית.
  4. בהודעה mysql>, מזינים את הטקסט הבא כדי ליצור את המשתמש devportal:
    mysql>create user 'devportal'@'localhost' מזוהה על ידי 'devportal';
    mysql> נותנים את כל ההרשאות ב-*.* ל-'devportal'@'localhost';
    mysql> Flush permissions;
    mysql>
  5. בהודעה שמופיעה במערכת, יוצרים את מסד הנתונים devportal:
    > mysqladmin -u devportal -p create devportal

    מזינים את הסיסמה של devportal.
  6. מתחברים ל-MySQL ומעניקים גישה ל-devportal מכתובת ה-IP של שרת הפורטל:
    mysql> GRANT ALL ON devportal.* אל devportal@'portalIP' שזוהה על ידי 'devportalPW';

    כאשר portalIP היא כתובת ה-IP של שרת הפורטל, ו-devportalPW היא הסיסמה של המשתמש ב-devportal.
  7. עורכים את /etc/my.cnf כדי להגדיר כתובת bind-address לכתובת ה-IP של שרת MySQL.
  8. מפעילים מחדש את MySQL:
    > /etc/init.d/mysqld הפעלה מחדש
  9. חשוב לוודא שיציאה 3306 פתוחה בשרת MySQL. התהליך הזה מבוסס על מערכת ההפעלה שלכם. לדוגמה, ב-Linux, משתמשים בפקודה:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j Accept

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

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

ל-RHEL יש דרישות נוספות, כי נדרש מינוי כדי לגשת להורדות תוכנה מ-RHEL. השרת חייב להיות מסוגל להתחבר לאינטרנט כדי להוריד 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

כברירת מחדל, הפורטל שולח אימייל באמצעות הפונקציה PHP mail(). 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 כדי להוריד 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 עבור ענן פרטי, כתובת ה-URL היא בפורמט הבא:
      http://EdgeIp:8080/v1

      או:
      https://EdgeIp:SSLport/v1

      כאשר EdgeIp היא כתובת ה-IP של שרת הניהול של Edge עבור יציאת SSL ו-API של יציאת Edge היא כתובת ה-IP של יציאת SSL. לדוגמה, 8443.
    2. שם הארגון ב-Apigee: יש קשר בין פורטלים לבין ארגוני Apigee Edge. את ארגון ברירת המחדל מגדירים כשתגדירו את נקודת הקצה (endpoint) של ממשק ה-API לניהול. ערך ברירת המחדל הוא my-org.
    3. שם משתמש וסיסמה לנקודת הקצה של ה-API לניהול: האדמין בארגון צריך לבצע את הקריאות מהפורטל אל Edge.

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

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