הגדרת ממשק המשתמש החדש של Edge

במאמר הזה מוסבר איך להתקין ולהגדיר את ממשק המשתמש החדש של Edge ל-Apigee Edge for Private Cloud. בגרסה 4.54.00, ממשק המשתמש החדש של Edge מורכב משני רכיבי RPM:

  • ‫edge-management-ui: שרת הבק-אנד של ממשק המשתמש החדש של Edge.
  • edge-management-ui-static: נכסי האינטרנט הסטטיים של ממשק המשתמש החדש של Edge.

ממשק המשתמש החדש של Edge מותקן כברירת מחדל כשמריצים את setup.sh עם הפרופיל aio (הכול באחד), sa (עצמאי) או ms (שרת ניהול), או שאפשר להתקין אותו באופן עצמאי בצומת באמצעות הפרופיל ue.

דרישות מוקדמות

לפני שמתקינים או מגדירים את ממשק המשתמש החדש של Edge בהתקנה של Apigee Edge for Private Cloud, צריך לוודא שהצומת עומד בדרישות הבאות:

  • דרישות החומרה ומערכת ההפעלה:
    • זיכרון RAM בנפח 4GB
    • 2 ליבות CPU
    • מקום בכונן בנפח 60GB
    • גרסה 4.54.00 של כלי השירות apigee-setup מותקנת בצומת כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
    • היציאה 3001 צריכה להיות פתוחה. זו יציאת ברירת המחדל שמשמשת לבקשות לממשק המשתמש של New Edge. אם משנים את היציאה באמצעות המאפיינים שמתוארים בקובץ התצורה של ממשק המשתמש החדש של Edge, צריך לוודא שהיציאה פתוחה.
  • אימות:
    • אימות בסיסי (ברירת מחדל): מופעל כברירת מחדל (AUTH_MODE=basic). משתמש בפרטי הכניסה של Edge Management Server ו-SymasLDAP בלי לדרוש ספק זהויות (IDP) חיצוני.
    • ‫SSO / ספק זהויות חיצוני (אופציונלי): אפשר להגדיר מודול SSO ב-Apigee או ספק זהויות חיצוני (כמו SAML או OIDC). אם אתם מתחברים ל-IdP חיצוני באמצעות TLS, ה-IdP צריך לתמוך ב-TLS בגרסה 1.2 ואילך.

מידע נוסף על התכונות של ממשק המשתמש החדש של Edge זמין במאמר ממשק המשתמש החדש של Edge ל-Private Cloud.

סקירה כללית על ההתקנה וההגדרה

באופן כללי, התהליך להתקנה או להגדרה מחדש של ממשק המשתמש החדש של Edge באמצעות הפרופיל ue הוא:

  • מוודאים שהכלי apigee-setup מותקן בצומת.
  • יוצרים קובץ תצורה שקט ומשנים אותו לפי ההגדרות שלכם.
  • מריצים את /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile. הפקודה הזו מתקינה ומגדירה גם את edge-management-ui וגם את edge-management-ui-static.
  • מתחברים למערכת ובודקים את ממשק המשתמש החדש של Edge בכתובת http://new_edge_UI_IP:3001.

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

קובץ התצורה של ממשק המשתמש החדש של Edge

בדוגמה הבאה מוצג קובץ תצורה להתקנה ולהגדרה של ממשק המשתמש החדש של Edge עם אימות בסיסי כברירת מחדל.

הגדרת אימות בסיסי (ברירת מחדל)

# IP of the Edge Management Server.
IP1=management_server_IP

# IP of the New Edge UI node (can be the same as IP1 or a separate node).
IP2=new_edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# New Edge UI configuration.
#
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

# Authentication mode (basic is default)
AUTH_MODE=basic

## SMTP Configuration
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.example.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company <myco@company.com>"

התקנה או הגדרה של ממשק המשתמש החדש של Edge

כדי להתקין או להגדיר את ממשק המשתמש החדש של Edge באמצעות פרופיל ue:

  1. התחבר לצומת היעד כמנהל מערכת.
  2. מתקינים את גרסה 4.54.00 של כלי השירות apigee-setup בצומת, כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
  3. כדי לנקות את כל המידע שנשמר במטמון באמצעות Yum, מריצים את הפקודה הבאה: 
    sudo yum clean all
  4. יוצרים את קובץ התצורה כמו שמתואר בקטע קובץ תצורה חדש של ממשק המשתמש של Edge, ומוודאים שהוא בבעלות המשתמש "apigee": 
    chown apigee:apigee configFile
  5. בצומת, מריצים את הפקודה הבאה: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    הכלי apigee-setup מתקין ומגדיר את edge-management-ui ואת edge-management-ui-static.

  6. מתחברים לממשק המשתמש החדש של Edge על ידי פתיחת כתובת ה-URL הבאה בדפדפן: 
    http://new_edge_UI_IP:3001

    ‫new_edge_UI_IP היא כתובת ה-IP או שם המארח של הצומת שמארח את ממשק המשתמש של New Edge.

  7. מזינים את פרטי הכניסה.

    ממשק המשתמש החדש של Edge מופיע. למידע על השימוש בממשק המשתמש החדש של Edge, ראו ממשק המשתמש החדש של Edge ל-Private Cloud.

    אם ממשק המשתמש החדש של Edge לא מוצג, מוודאים שיציאה 3001 פתוחה לחיבורים.

אופציונלי: אם רוצים להגדיר את מודול ה-SSO ב-Apigee לאימות, פועלים לפי השלבים שמפורטים במאמרים התקנה והגדרה של מודול ה-SSO ב-Apigee והפעלת IDP חיצוני בממשק המשתמש החדש של Edge.

הסרת הממשק החדש של Edge

כדי להסיר את ממשק המשתמש החדש של Edge מצומת, צריך להסיר את הרכיבים edge-management-ui ו-edge-management-ui-static.

כדי להסיר את הרכיבים של ממשק המשתמש החדש של Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall

כדי להסיר את כל רכיבי Edge מהצומת:

  1. עוצרים את כל שירותי Edge שפועלים במכונה: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. מנקים את המטמון של yum: 
    sudo yum clean all
  3. מסירים את כל חבילות ה-RPM של Apigee: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. מסירים את תיקיית השורש של ההתקנה: 
    sudo rm -rf /opt/apigee