דרישות התקנה

Edge for Private Cloud גרסה 4.18.01

דרישות חומרה

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

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

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

ברשימה הבאה מפורטות הדרישות לחומרה כדי להתקין BaaS של API:

דרישות מערכת הפעלה ותוכנה של צד שלישי

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

יצירת המשתמש בממשק API

תהליך ההתקנה יוצר משתמש מערכת Unix בשם 'apigee'. ספריות וקבצים של Edge הם בבעלות 'apigee', וכך גם תהליכי Edge. כלומר, רכיבי Edge פועלים בתור המשתמש 'apigee'. אם צריך, אפשר להריץ רכיבים כמשתמש אחר.

ספריית התקנה

כברירת מחדל, מנהל ההתקנה כותב את כל הקבצים בספרייה /opt/apigee. לא ניתן לשנות את המיקום הזה של הספרייה. אמנם לא ניתן לשנות את הספרייה הזו, אבל אפשר ליצור קישור סמלי כדי למפות את /opt/apigee למיקום אחר, כפי שמתואר בהמשך.

בהוראות שבמדריך הזה, ספריית ההתקנה רשומה בתור /opt/apigee.

יצירת קישור סימבולי מ- /opt/apigee

לפני שיוצרים את הקישור הסמלי, צריך ליצור משתמש וקבוצה בשם "apigee". זוהי אותה הקבוצה והמשתמש שנוצרו על ידי מנהל ההתקנה של Edge.

כדי ליצור את הקישור הסמלי, יש לבצע את השלבים הבאים לפני שמורידים את הקובץ shoestrap_4.18.01.sh. צריך לבצע את כל השלבים הבאים בתור הרמה הבסיסית (root):

1. יוצרים את המשתמש והקבוצה "apigee":

   groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee

2. יוצרים קישור סימבולי מ-/opt/apigee לבסיס ההתקנה הרצוי:

   ln -Ts /srv/myInstallDir /opt/apigee

   כאשר /srv/myInstallDir הוא המיקום הרצוי של קובצי Edge.

3. שינוי הבעלות על בסיס ההתקנה ועל קישור סמלי למשתמש ה-API:

   chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Java

לפני ההתקנה, צריכה להיות מותקנת גרסה נתמכת של Java 1.8 בכל מחשב. מפתחות ה-JDK הנתמכים מפורטים בתוכנות הנתמכות ובגרסאות הנתמכות.

צריך לוודא ש-JAVA_HOME מפנה לבסיס ה-JDK של המשתמש שמבצע את ההתקנה.

SELinux

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

הגדרת רשת

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

• הפונקציה hostname מחזירה את שם המכונה
• hostname -i מחזירה את כתובת ה-IP של שם המארח שאפשר להפנות אליו ממכונות אחרות.

בהתאם לסוג ולגרסה של מערכת ההפעלה, יכול להיות שיהיה צורך לערוך את /etc/hosts ואת /etc/sysconfig/network אם שם המארח לא מוגדר בצורה נכונה. למידע נוסף, עיינו בתיעוד של מערכת ההפעלה הספציפית שלכם.

אם לשרת יש כמה כרטיסי ממשק, הפקודה 'שם מארח -i' מחזירה רשימה של כתובות IP שמופרדות ברווחים. כברירת מחדל, מנהל ההתקנה של Edge משתמש בכתובת ה-IP הראשונה שמוחזרת, וייתכן שהיא לא תהיה נכונה בכל המצבים. לחלופין, אפשר להגדיר את המאפיין הבא בקובץ תצורת ההתקנה:

ENABLE_DYNAMIC_HOSTIP=y

כשהמאפיין הזה מוגדר ל-y, מנהל ההתקנה יבקש מכם לבחור את כתובת ה-IP שתשמש במסגרת ההתקנה. ערך ברירת המחדל הוא 'n'. מידע נוסף זמין בחומר העזר בנושא קובצי תצורת קצה.

קובצי wrapper של TCP

רכיבי TCP wrappers יכולים לחסום את התקשורת של יציאות מסוימות, והם יכולים להשפיע על ההתקנה של OpenLDAP, Postgres ו-Cassandra. בצמתים האלה, צריך לבדוק את /etc/hosts.allow ואת /etc/hosts.deny כדי לוודא שאין הגבלות על היציאות הנדרשות ב-OpenLDAP, ב-Postgres וב-Cassandra.

iptables, אייפטבל

בדיקה שאין מדיניות ל-IPtables שמונעת קישוריות בין צמתים ביציאות Edge הנדרשות. אם צריך, אפשר לעצור את ההפעלה של מכשירי iptable במהלך ההתקנה באמצעות הפקודה:

sudo/etc/init.d/iptables stop

ב-CentOS 7.x:

systemctl stop firewalld

בדיקה של נתב Edge יכול לגשת אל /etc/rc.d/init.d/functions

הצמתים של Edge Router ו-BaaS Portal משתמשים בנתב Nginx ודורשים גישת קריאה ל-/etc/rc.d/init.d/functions.

אם תהליך האבטחה דורש הגדרה של הרשאות ב-/etc/rc.d/init.d/functions, אין להגדיר אותן ל-700, אחרת הנתב לא יוכל לפעול. אפשר להגדיר את ההרשאות ל-744 כדי לתת גישת קריאה אל /etc/rc.d/init.d/functions.

קסנדרה

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

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

אחרי שמתקינים את Edge for Private Cloud, אפשר לבדוק אם Cassandra מוגדרת נכון, על ידי בדיקת הקובץ /opt/apigee/apigee-cassandra/conf/cassandra.yaml. לדוגמה, צריך לוודא שהסקריפט להתקנה של Edge לענן הפרטי מגדיר את המאפיינים הבאים:

• cluster_name
• initial_token
• partitioner
• seeds
• listen_address
• rpc_address
• snitch

מסד נתונים PostgreSQL

אחרי שמתקינים את Edge, אפשר לשנות את ההגדרות הבאות של מסד הנתונים של PostgreSQL בהתאם לנפח ה-RAM הזמין במערכת:

conf_postgresql_shared_buffers = 35% of RAM      # min 128kB
conf_postgresql_effective_cache_size = 45% of RAM
conf_postgresql_work_mem = 512MB       # min 64kB

כדי להגדיר את הערכים האלה:

1. עורכים את הקובץ postgresql.properties:

   vi /opt/apigee/customer/application/postgresql.properties

   אם הקובץ לא קיים, יוצרים אותו.

2. מגדירים את המאפיינים שמפורטים למעלה.
3. שומרים את השינויים.
4. מפעילים מחדש את מסד הנתונים של PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

מגבלות מערכת

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

• בצומתי Cassandra, צריך להגדיר מגבלות רך וקשה, nofile ומרחב כתובות (כפי) עבור משתמש ההתקנה (ברירת המחדל היא "apigee") ב-/etc/security/limits.d/90-apigee-edge-limits.conf כפי שמוצג כאן:

  apigee soft memlock unlimited
  apigee hard memlock unlimited
  apigee soft nofile 32768
  apigee hard nofile 65536
  apigee soft as unlimited
  apigee hard as unlimited

• בצמתים של מעבדי הודעות, צריך להגדיר את המספר המקסימלי של מתארי הקבצים הפתוחים ל-64K ב-/etc/security/limits.d/90-apigee-edge-limits.conf כפי שמוצג כאן:

  apigee soft nofile 32768
  apigee hard nofile 65536

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

jsvc

'jsvc' הוא דרישה מוקדמת לשימוש ב-API BaaS. גרסה 1.0.15-dev מותקנת כאשר מתקינים את ה-BaaS של ה-API.

שירותי אבטחת רשת (NSS)

Network Security Services (NSS) היא קבוצת ספריות שתומכת בפיתוח של אפליקציות לקוח ושרת שמופעלות על ידי אבטחה. עליך לוודא שהתקנת את NSS את גרסה 3.19 ואילך.

כדי לבדוק את הגרסה הנוכחית:

yum info nss

כדי לעדכן את ה-NSS:

yum update nss

מידע נוסף זמין במאמר הזה מ-RedHat.

השבתה של חיפוש DNS ב-IPv6 בעת שימוש ב-NSCD (Name Service Cache Daemon)

אם התקנתם והפעלתם את ה-NSCD (Name Service Cache Daemon), מעבדי ההודעות יבצעו שני חיפושי DNS: אחד עבור IPv4 ואחד עבור IPv6. כדאי להשבית חיפוש DNS ב-IPv6 כשמשתמשים ב-NSCD.

כדי להשבית את חיפוש ה-DNS ב-IPv6:

1. בכל צומת של מעבד ההודעות, יש לערוך את /etc/nscd.conf
2. מגדירים את המאפיין הבא:

   enable-cache hosts no

השבתה של IPv6 ב-Google Cloud Platform ל-RedHat/CentOS 7

אם אתם מתקינים את Edge ב-RedHat 7 או את CentOS 7 ב-Google Cloud Platform, צריך להשבית את IPv6 בכל צומתי Qpid.

לקבלת הוראות להשבתת IPv6, אפשר לעיין בתיעוד של RedHat או CentOS לגבי הגרסה הספציפית של מערכת ההפעלה. תוכלו, לדוגמה:

1. פתיחת /etc/hosts בעורך.
2. כדי להגיב לו, מוסיפים תו "#" בעמודה אחת בשורה הבאה:

   #::1 localhost localhost.localdomain localhost6 localhost6.localdomain6

3. שומרים את הקובץ.

AWS AMI

אם אתם מתקינים Edge ב-AWS Amazon Machine Image (AMI) עבור Red Hat Enterprise Linux 7.x, צריך קודם להריץ את הפקודה הבאה:

yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

כלים

מנהל ההתקנה משתמש בכלי UNIX הבאים בגרסה הרגילה, כפי שסופק על ידי EL5 או EL6.

ntpdate

מומלץ לסנכרן את זמני השרתים. אם תוכנית השירות ntpdate לא מוגדרת כבר, היא יכולה לשמש למטרה הזו שמאמתת אם השרתים מסונכרנים לפי זמן. אפשר להשתמש ב-yum install ntp כדי להתקין את כלי השירות. האפשרות הזו שימושית במיוחד לשכפול הגדרות OpenLDAP. שימו לב שהגדרתם את אזור הזמן של השרת לפי שעון UTC.

openldap 2.4

ההתקנה המקומית מחייבת OpenLDAP 2.4. אם לשרת יש חיבור לאינטרנט, סקריפט ההתקנה של Edge יוריד ויתקין את OpenLDAP. אם לשרת שלך אין חיבור לאינטרנט, עליך לוודא ש-OpenLDAP כבר מותקן לפני הפעלת הסקריפט להתקנת Edge. ב-RHEL/CentOS, אפשר להריץ את yum install openldap-clients openldap-servers כדי להתקין את OpenLDAP.

להתקנות עם 13 מארחים ולהתקנות של 12 מארחים עם שני מרכזי נתונים, צריך שכפול של OpenLDAP כי יש צמתים מרובים שמארחים את OpenLDAP.

חומות אש ומארחים וירטואליים

לרוב, המונח virtual מקבל עומס יתר בזירת ה-IT, וכך הוא מופיע ב-Apigee Edge לפריסה של ענן פרטי ומארחים וירטואליים. לשם הבהרה, יש שני שימושים עיקריים במונח virtual:

• מכונות וירטואליות (VM): לא חובה לעשות זאת, אבל בחלק מהפריסות נעשה שימוש בטכנולוגיית מכונות וירטואליות כדי ליצור שרתים מבודדים לרכיבי Apigee שלהם. למארחי מכונות וירטואליות, כמו מארחים פיזיים, יכולים להיות ממשקי רשת וחומות אש.
• מארחים וירטואליים: נקודות קצה באינטרנט, בדומה למארח וירטואלי של Apache.

נתב במכונה וירטואלית יכול לחשוף כמה מארחים וירטואליים (כל עוד הם שונים זה מזה בכינוי המארח או ביציאת הממשק שלו).

הנה דוגמה לשמות, יכול להיות שבשרת פיזי יחיד A פועלות שתי מכונות וירטואליות – שנקראות VM1 ו-VM2. נניח ש-'VM1' חושף ממשק Ethernet וירטואלי שנקרא 'eth0' בתוך המכונה הווירטואלית, ושכתובת ה-IP המוקצית לו היא 111.111.111.111 על ידי מכונות הווירטואליות או שרת DHCP של הרשת. לאחר מכן, נניח ש-VM2 חושפת ממשק אתרנט וירטואלי שנקרא eth0, ומוקצה לו כתובת IP 111.111.111.222.

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

נתב Apigee ב-VM1 חושף שלושה מארחים וירטואליים בממשק ה-eth0 שלו (יש לו כתובת IP מסוימת), api.mycompany.com:80, api.mycompany.com:443 ו-test.mycompany.com:80.

הנתב ב-VM2 חושף את api.mycompany.com:80 (אותו שם ויציאה כפי שהם נחשפו על ידי VM1).

יכול להיות שבמערכת ההפעלה של המארח הפיזי יש חומת אש של רשת. במקרה כזה, צריך להגדיר את חומת האש הזו להעביר תעבורת TCP שקשורה ליציאות הנחשפות בממשקים הווירטואליים (111.111.111.111:{80, 443} ו-111.111.111.222:80). בנוסף, כל מערכת הפעלה של מכונה וירטואלית יכולה לספק חומת אש משלה בממשק ה-eth0, וגם הן צריכות לאפשר ליציאות 80 ו-443 להתחבר.

נתיב הבסיס הוא הרכיב השלישי שמעורב בניתוב קריאות ל-API לשרתי proxy שונים של API שאולי פרסת. חבילות proxy של API יכולות לשתף נקודת קצה אם יש להן נתיב בסיס שונה. לדוגמה, אפשר להגדיר נתיב בסיסי אחד כ-http://api.mycompany.com:80/ ונתיב בסיסי אחר יכול להיות מוגדר כ-http://api.mycompany.com:80/salesdemo.

במקרה כזה, יש צורך במאזן עומסים או במנהל תעבורת נתונים מסוג כלשהו שמפצל את תעבורת הנתונים http://api.mycompany.com:80/ בין שתי כתובות ה-IP (111.111.111.111 ב-VM1 ו-111.111.111.222 ב-VM2). הפונקציה הזו היא ספציפית להתקנה הספציפית שלכם, והיא מוגדרת על ידי קבוצת הרשת המקומית.

נתיב הבסיס מוגדר בזמן פריסת ה-API. מהדוגמה שלמעלה, אפשר לפרוס שני ממשקי API, mycompany ו-testmycompany, עבור הארגון mycompany-org, עם המארח הווירטואלי שיש לו כינוי המארח api.mycompany.com ושהיציאה מוגדרת ל-80. אם לא מצהירים על נתיב בסיס בפריסה, הנתב לא יידע לאיזה API לשלוח בקשות נכנסות.

עם זאת, אם תטמיעו את ה-API testmycompany שכתובת ה-URL הבסיסית שלו היא /salesdemo, המשתמשים יוכלו לגשת ל-API הזה באמצעות http://api.mycompany.com:80/salesdemo. אם פריסת ה-API שלך היא mycompany עם כתובת ה-URL הבסיסית /, המשתמשים שלך ניגשים ל-API באמצעות כתובת ה-URL http://api.mycompany.com:80/.

הדרישות לגבי יציאת Edge

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

בתמונה הבאה אפשר לראות את דרישות היציאות לכל רכיב Edge:

הערות בתרשים הזה:

• * יציאה 8082 במעבד ההודעות צריכה להיות פתוחה לגישה מהנתב רק כאשר מגדירים TLS/SSL בין הנתב למעבד ההודעות. אם לא מגדירים TLS/SSL בין הנתב למעבד ההודעות, הגדרת ברירת המחדל, יציאה 8082 עדיין צריכה להיות פתוחה במעבד ההודעות כדי לנהל את הרכיב, אבל הנתב לא מחייב גישה אליו.
• היציאות עם הקידומת M הן יציאות המשמשות לניהול הרכיב. היציאות חייבות להיות פתוחות ברכיב וצריכות להיות פתוחות ברכיב כדי לאפשר גישה של שרת הניהול.
• הרכיבים הבאים דורשים גישה ליציאה 8080 בשרת הניהול: נתב, מעבד הודעות, ממשק משתמש, Postgres ו-Qpid.
• מעבד הודעות חייב לפתוח את יציאה 4528 כיציאת הניהול שלו. אם יש לך כמה מעבדי הודעות, כולם צריכים להיות מסוגלים לגשת זה לזה ביציאה 4528 (אם יש לך חץ הלולאה שמופיע בתרשים שלמעלה לגבי יציאה 4528 במעבד ההודעות). אם יש לך מספר מרכזי נתונים, היציאה צריכה להיות נגישה מכל מעבדי ההודעות בכל מרכזי הנתונים.
• למרות שזו לא חובה, אפשר לפתוח את יציאה 4527 בנתב כדי לקבל גישה לכל מעבד הודעות. אחרת, ייתכן שיופיעו הודעות שגיאה בקובצי היומן של מעבד ההודעות.
• נתב חייב לפתוח את יציאה 4527 כיציאת הניהול שלו. אם יש לך כמה נתבים, לכולם צריכה להיות גישה זה לזה דרך יציאה 4527 (הדבר יצוין באמצעות חץ הלולאה בתרשים שלמעלה לגבי יציאה 4527 בנתב).
• כדי לתמוך בלחצן Send בכלי המעקב, בממשק המשתמש של Edge נדרשת גישה לנתב, ביציאות החשופות של שרתי ה-proxy של ה-API.
• עליך להעניק לשרת הניהול גישה ליציאת JMX בצומתי Cassandra.
• אפשר להגדיר את הגישה ליציאות JMX כך שתדרוש שם משתמש/סיסמה. מידע נוסף זמין במאמר איך עוקבים אחרי.
• אפשר להגדיר גישה ל-TLS/SSL בחיבורים מסוימים, שיכולים להשתמש ביציאות שונות. אפשר לקרוא מידע נוסף בקטע TLS/SSL.
• אם מגדירים שני צומתי Postgres לשימוש בשכפול של מצב המתנה ראשית, צריך לפתוח את יציאה 22 בכל צומת לגישת SSH. אפשר לפתוח יציאות בצמתים נפרדים כדי לאפשר גישת SSH.
• אפשר להגדיר את שרת הניהול ואת ממשק המשתמש של Edge לשליחת אימיילים דרך שרת SMTP חיצוני. צריך לוודא ששרת הניהול וממשק המשתמש יכולים לגשת ליציאה הדרושה בשרת ה-SMTP. ב-SMTP שאינו TLS, מספר היציאה הוא בדרך כלל 25. ב-SMTP שמופעל בו TLS, בדרך כלל הוא 465, אבל יש לבדוק זאת עם ספק ה-SMTP.

בטבלה הבאה אפשר לראות שצריך לפתוח את היציאות בחומות אש באמצעות רכיב Edge:

curl -v http://routerIP:15999/v1/servers/self/reachable

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

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

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

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

1. צריך להגדיר את הערך net.ipv4.tcp_keepalive_time = 1800 בהגדרות ה-sysctl במערכת ההפעלה Linux, כאשר 1800 צריך להיות נמוך יותר מהזמן הקצוב לתפוגה של תוכנית ה-tcp ללא פעילות בחומת האש. ההגדרה הזו צריכה להשאיר את החיבור במצב קיים כדי שחומת האש לא תנתק את החיבור.
2. בכל מערכות העיבוד של ההודעות, צריך לערוך את /opt/apigee/customer/application/message-processor.properties כדי להוסיף את המאפיין הבא. אם הקובץ לא קיים, יוצרים אותו.

   conf_system_cassandra.maxconnecttimeinmillis=-1

3. מפעילים מחדש את מעבד ההודעות:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

4. בכל הנתבים, צריך לערוך את /opt/apigee/customer/application/router.properties כדי להוסיף את הנכס הבא. אם הקובץ לא קיים, יוצרים אותו.

   conf_system_cassandra.maxconnecttimeinmillis=-1

5. מפעילים מחדש את הנתב:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

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

הדרישות ליציאת BaaS ל-API

אם תבחרו להתקין את ממשקי BaaS של ה-API, תצטרכו להוסיף את הרכיבים של Stack BaaS Stack ו-API BaaS Portal. הרכיבים האלה משתמשים ביציאות שמוצגות באיור למטה:

הערות בתרשים הזה:

• פורטל BaaS של ה-API לעולם לא שולח בקשות ישירות לצומת ב-BaaS Stack. כשמפתח מתחבר לפורטל, אפליקציית הפורטל יורדת לדפדפן. אפליקציית הפורטל שפועלת בדפדפן שולחת בקשות לצומתי BaaS Stack.
• במהלך התקנה של API BaaS בסביבת ייצור, נעשה שימוש במאזן עומסים בין הצומת של פורטל BaaS של ה-API לבין הצמתים של Stack BaaS ב-API. כשמגדירים את הפורטל, וכשמבצעים קריאות ל-BaaS API, צריך לציין את כתובת ה-IP או את שם ה-DNS של מאזן העומסים, ולא של צומתי ה-Stack.
• כל צומתי ה-Stack חייבים לפתוח את יציאה 2551 כדי שתהיה גישה מכל שאר צומתי ה-Stack (מצוינים על ידי חץ הלולאה בתרשים שלמעלה לגבי יציאה 2551 בצומת ה-Stack). אם יש לכם מספר מרכזי נתונים, היציאה צריכה להיות נגישה מכל צומתי Stack בכל מרכזי הנתונים.
• צריך להגדיר את כל צומתי Baas Stack לשליחת אימיילים דרך שרת SMTP חיצוני. ב-SMTP שאינו TLS, מספר היציאה הוא בדרך כלל 25. ב-SMTP שמופעל בו TLS, בדרך כלל הוא 465, אבל יש לבדוק זאת עם ספק ה-SMTP.
• אפשר להקצות את צומתי Cassandra ל-API BaaS, או לשתף אותם עם Edge.

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

רישוי

לכל התקנה של Edge נדרש קובץ רישיון ייחודי שמקבלים מ-Apigee. כשמתקינים את שרת הניהול, צריך לספק את הנתיב לקובץ הרישיון, לדוגמה /tmp/License.txt.

המתקין מעתיק את קובץ הרישיון אל /opt/apigee/customer/conf/license.txt.

אם קובץ הרישיון תקף, שרת הניהול מאמת את תפוגת התוקף ומתיר את הספירה של מעבדי ההודעות (MP). אם פג התוקף של הגדרת רישיון כלשהי, תוכלו למצוא את היומנים במיקום הבא: /opt/apigee/var/log/edge-management-server/logs. במקרה כזה, אפשר לפנות לתמיכה של Apigee Edge כדי לקבל את פרטי ההעברה.

אם עדיין אין לכם רישיון, תוכלו לפנות ל-Apigee Sales.