پیکربندی واسط کاربر New Edge

این سند نحوه نصب و پیکربندی New Edge UI را برای Apigee Edge برای Private Cloud شرح می‌دهد. در نسخه ۴.۵۴.۰۰، «واسط کاربر New Edge» از دو عنصر «درآمد به‌ازای هر هزار بازدید» تشکیل شده است:

  • ‫edge-management-ui: سرور زیرینه میانای کاربر New Edge.
  • edge-management-ui-static: دارایی‌های وب ایستا برای واسط کاربری New Edge UI.

«واسط کاربر Edge جدید» به‌طور پیش‌فرض هنگام اجرای setup.sh با نمایه aio (همه در یک)، sa (مستقل)، یا ms (سرور مدیریت) نصب می‌شود، یا می‌تواند به‌طور مستقل در گره بااستفاده از نمایه ue نصب شود.

پیش‌نیازها

قبل‌از نصب یا پیکربندی New Edge UI در نصب Apigee Edge for Private Cloud، مطمئن شوید گره شرایط زیر را برآورده می‌کند:

  • الزامات سخت‌افزار و سیستم‌عامل:
    • ‫۴ گیگابایت حافظه دسترسی تصادفی
    • واحد پردازش مرکزی با ۲ هسته
    • ‫۶۰ گیگابایت فضای دیسک
    • نسخه 4.54.00 از ابزار کمکی apigee-setup نصب‌شده در گره، همان‌طور که در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است.
    • درگاه ۳۰۰۱ باید باز باشد. این درگاه پیش‌فرضی است که برای درخواست‌ها به New Edge UI استفاده می‌شود. اگر بااستفاده از دارایی‌های شرح‌داده‌شده در فایل پیکربندی میانای کاربری Edge جدید درگاه را تغییر می‌دهید، مطمئن شوید که درگاه باز باشد.
  • اصالت‌سنجی:
    • اصالت‌سنجی پایه (پیش‌فرض): به‌طور پیش‌فرض فعال است (AUTH_MODE=basic). از اعتبارنامه‌های Edge Management Server و SymasLDAP بدون نیاز به «ارائه‌دهنده هویت» (IDP) خارجی استفاده می‌کند.
    • SSO / ارائه‌دهنده هویت خارجی (اختیاری): می‌توانید به‌صورت اختیاری SSO Apigee یا ارائه‌دهنده هویت خارجی (مثل SAML یا OIDC) را پیکربندی کنید. اگر ازطریق TLS به ارائه‌دهنده هویت خارجی متصل می‌شوید، ارائه‌دهنده هویت شما باید از TLS نسخه ۱.۲ یا بالاتر پشتیبانی کند.

برای اطلاعات بیشتر درباره ویژگی‌های «واسط کاربر Edge جدید»، به واسط کاربر Edge جدید برای Private Cloud مراجعه کنید.

نمای کلی نصب و پیکربندی

در سطح بالا، فرایند نصب یا پیکربندی مجدد New Edge UI بااستفاده از نمایه ue به‌صورت زیر است:

  • مطمئن شوید ابزار apigee-setup در گره نصب شده باشد.
  • فایل پیکربندی بی‌صدا ایجاد کنید و آن را با تنظیمات خودتان اصلاح کنید.
  • ‫/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile را اجرا کنید. این کار هم edge-management-ui و هم edge-management-ui-static را نصب و پیکربندی می‌کند.
  • به سیستم وارد شوید و New Edge UI را در http://new_edge_UI_IP:3001 آزمایش کنید.

اگر «سرور مدیریت» و سرور «واسط کاربر Edge جدید» شما پشت ترازکننده بار با برون‌سپاری «امنیت لایه انتقال» در ترازکننده بار قرار دارند، مطمئن شوید پیکربندی ویژگی‌های برجسته در پیکربندی «واسط کاربر Edge جدید» وقتی «امنیت لایه انتقال» در ترازکننده بار پایان می‌یابد را منعکس می‌کند.

فایل پیکربندی واسط کاربر Edge جدید

مثال زیر فایل پیکربندی را برای نصب و پیکربندی New Edge UI با اصالت‌سنجی پیش‌فرض Basic نشان می‌دهد.

پیکربندی اصالت‌سنجی پایه (پیش‌فرض)

# 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>"

نصب یا پیکربندی واسط کاربر New Edge

برای نصب یا پیکربندی New Edge UI بااستفاده از نمایه ue:

  1. به‌عنوان سرپرست به گره هدف وارد شوید.
  2. نسخه ۴.۵۴.۰۰ ابزار apigee-setup را در گره نصب کنید، همان‌طور که در نصب ابزار Edge apigee-setup توضیح داده شده است.
  3. با اجرای فرمان زیر، همه اطلاعات ذخیره‌شده در حافظه نهان را با Yum پاک کنید: 
    sudo yum clean all
  4. فایل پیکربندی را همان‌طور که در فایل پیکربندی رابط کاربری New 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 UI وارد شوید: 
    http://new_edge_UI_IP:3001

    که در آن new_edge_UI_IP نشانی IP یا نام میزبان گرهی است که میزبان «واسط کاربر New Edge» است.

  7. اطلاعات اعتباری‌تان را وارد کنید.

    رابط کاربری New Edge ظاهر می‌شود. برای کسب اطلاعات درباره استفاده از New Edge UI، به New Edge UI for Private Cloud مراجعه کنید.

    اگر «میانای کاربری Edge جدید» نمایش داده نمی‌شود، مطمئن شوید که درگاه ۳۰۰۱ برای اتصالات باز است.

اختیاری: اگر می‌خواهید Apigee SSO را برای اصالت‌سنجی پیکربندی کنید، مراحل موجود در نصب و پیکربندی Apigee SSO و فعال کردن IDP خارجی در رابط کاربری New Edge را دنبال کنید.

حذف نصب واسط کاربر Edge جدید

برای حذف نصب New Edge UI از یک گره، هر دو مؤلفه 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. همه Apigee RPM را بردارید: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. دایرکتوری ریشه نصب را بردارید: 
    sudo rm -rf /opt/apigee