ضبط واجهة مستخدم Edge الجديدة

يوضّح هذا المستند كيفية تثبيت واجهة مستخدم New Edge وتكوينها في Apigee Edge Private Cloud. في الإصدار 4.54.00، تتألف واجهة مستخدم New Edge من مكوّنَين من مكوّنات RPM:

  • ‫edge-management-ui: خادم الخلفية لواجهة مستخدم Edge الجديدة
  • ‫edge-management-ui-static: مواد عرض الويب الثابتة لواجهة New Edge UI الأمامية

يتم تثبيت واجهة مستخدم Edge الجديدة تلقائيًا عند تشغيل setup.sh باستخدام الملف الشخصي aio (الكل في واحد) أو sa (مستقل) أو ms (خادم الإدارة)، أو يمكن تثبيتها بشكل مستقل على عقدة باستخدام الملف الشخصي ue.

المتطلبات الأساسية

قبل تثبيت واجهة مستخدم Edge الجديدة أو ضبطها في عملية تثبيت Apigee Edge للسحابة الخاصة، تأكَّد من أنّ العُقدة تستوفي المتطلبات التالية:

  • متطلبات الأجهزة ونظام التشغيل:
    • ذاكرة وصول عشوائي (RAM) بسعة 4 غيغابايت
    • نواة وحدة معالجة مركزية (CPU)
    • مساحة قرص تبلغ 60 غيغابايت
    • الإصدار 4.54.00 من أداة apigee-setup المساعدة المثبّتة على العقدة كما هو موضّح في تثبيت أداة apigee-setup المساعدة في Edge.
    • يجب أن يكون المنفذ 3001 مفتوحًا. هذا هو المنفذ التلقائي المستخدَم لطلبات واجهة مستخدم New Edge. في حال تغيير المنفذ باستخدام السمات الموضّحة في ملف إعداد واجهة مستخدم Edge الجديدة، تأكَّد من أنّ المنفذ مفتوح.
  • المصادقة:
    • المصادقة الأساسية (الإعداد التلقائي): يتم تفعيلها تلقائيًا (AUTH_MODE=basic). تستخدم بيانات اعتماد Edge Management Server وSymasLDAP بدون الحاجة إلى موفِّر هوية خارجي.
    • الدخول الموحّد (SSO) / موفّر الهوية الخارجي (اختياري): يمكنك اختياريًا ضبط الدخول الموحّد (SSO) في Apigee أو موفّر هوية خارجي (مثل SAML أو OIDC). إذا كنت تتصل بموفِّر هوية خارجي عبر بروتوكول أمان طبقة النقل (TLS)، يجب أن يتوافق موفِّر الهوية مع الإصدار 1.2 من بروتوكول أمان طبقة النقل (TLS) أو إصدار أحدث.

لمزيد من المعلومات حول ميزات واجهة مستخدم Edge الجديدة، يمكنك الاطّلاع على واجهة مستخدم Edge الجديدة للسحابة الخاصة.

نظرة عامة على عملية التثبيت والإعداد

At a high level, the process for installing or reconfiguring the New Edge UI using the ue profile is as follows:

  • تأكَّد من تثبيت الأداة المساعدة 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 الجديد

يوضّح المثال التالي ملف إعداد لتثبيت واجهة مستخدم New 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 المساعدة على العقدة، كما هو موضّح في تثبيت أداة Edge apigee-setup المساعدة.
  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. سجِّل الدخول إلى واجهة مستخدم New 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 وضبطه وتفعيل موفِّر هوية خارجي على واجهة مستخدم Edge الجديدة.

إلغاء تثبيت واجهة مستخدم Edge الجديدة

لإلغاء تثبيت واجهة مستخدم Edge الجديدة من عقدة، عليك إلغاء تثبيت المكوّنَين edge-management-ui وedge-management-ui-static.

لإلغاء تثبيت مكوّنات واجهة مستخدم New 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. أزِل جميع حزم Apigee RPM: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. أزِل الدليل الجذري للتثبيت: 
    sudo rm -rf /opt/apigee