Cài đặt Trải nghiệm Edge mới (Beta)

Edge cho đám mây riêng tư phiên bản 4.18.01

Tài liệu này mô tả cách cài đặt bản phát hành thử nghiệm của trải nghiệm Edge mới cho Edge cho đám mây riêng tư. Trải nghiệm Edge mới là giao diện người dùng thế hệ tiếp theo cho Edge.

Để dùng thử trải nghiệm Edge mới trong bản cài đặt Edge cho đám mây riêng tư, bạn phải:

  • Bật SAML trên Edge. Phiên bản Edge mới chỉ hỗ trợ SAML làm cơ chế xác thực.
  • Cài đặt trải nghiệm Edge mới trên nút riêng. Bạn không thể cài đặt thành phần này trên một nút chứa các thành phần Edge khác.

Để biết thêm thông tin về trải nghiệm Edge mới, hãy xem bài viết Trải nghiệm Edge mới cho Private Cloud.

Tổng quan về quy trình cài đặt

Để cài đặt phiên bản thử nghiệm của trải nghiệm Edge mới cho Edge cho đám mây riêng tư, bạn thực hiện hai quy trình cài đặt khác nhau:

  • Cài đặt giao diện người dùng Edge cơ bản, được gọi là shoehorn và định cấu hình giao diện người dùng Edge cơ bản để sử dụng SAML nhằm xác thực với Edge.
  • Cài đặt trải nghiệm Edge mới và định cấu hình trải nghiệm Edge mới để sử dụng SAML nhằm xác thực với Edge. Sau khi cài đặt trải nghiệm Edge mới, bạn có thể đăng nhập và sử dụng để làm việc với Edge.

Điều kiện tiên quyết để cài đặt

  • Bạn phải bật SAML trên Edge trước khi cài đặt trải nghiệm Edge mới. Phiên bản Edge mới chỉ hỗ trợ SAML làm cơ chế xác thực.

    Lưu ý: Trong môi trường không phải môi trường thực tế, bạn có thể bật tính năng xác thực cơ bản trên Edge để người dùng giao diện người dùng cũ và Edge API vẫn có thể sử dụng tính năng xác thực cơ bản.

    Để biết thông tin về cách bật SAML trên Edge, hãy xem bài viết Hỗ trợ SAML trên Edge cho đám mây riêng tư.
  • Bạn phải cài đặt trải nghiệm Edge mới trên nút riêng của nó. Bạn không thể cài đặt thành phần này trên một nút chứa các thành phần Edge khác. Nút phải đáp ứng các yêu cầu sau:
    • JAVA 1.8
    • RAM 4 GB
    • 2 lõi
    • Dung lượng ổ đĩa 60 GB
    • Trước tiên, bạn phải cài đặt phiên bản 4.18.01 của tiện ích apigee-setup trên nút như mô tả tại phần Cài đặt tiện ích apigee-setup của Edge.

Những điều cần cân nhắc trước khi cài đặt trải nghiệm Edge mới

Như đã mô tả ở trên trong phần điều kiện tiên quyết, trải nghiệm Edge mới yêu cầu bạn bật SAML trên Edge. Điều này có nghĩa là quy trình xác thực người dùng do một nhà cung cấp dịch vụ danh tính (IDP) SAML kiểm soát, trong đó bạn định cấu hình IDP SAML để sử dụng địa chỉ email làm mã nhận dạng người dùng. Do đó, tất cả người dùng trải nghiệm New Edge đều phải được đăng ký trong SAML IDP.

Giao diện người dùng cũ của Edge, giao diện người dùng mặc định mà bạn đã cài đặt bằng Edge cho đám mây riêng tư, không yêu cầu SAML. Bạn có thể sử dụng SAML hoặc phương thức xác thực cơ bản. Điều đó có nghĩa là bạn có thể:

  • Bật tính năng hỗ trợ SAML trên Edge, cả trên giao diện người dùng cũ và trải nghiệm Edge mới.

    Trong trường hợp này, tất cả người dùng giao diện người dùng cũ và trải nghiệm Edge mới đều được đăng ký trong SAML IDP. Để biết thông tin về cách thêm người dùng mới vào IDP SAML, hãy xem phần Đăng ký người dùng Edge mới.
  • Bật tính năng hỗ trợ SAML trên Edge, nhưng vẫn bật phương thức xác thực cơ bản. Trải nghiệm Edge mới sử dụng SAML và giao diện người dùng cũ vẫn sử dụng phương thức xác thực cơ bản.

    Trong trường hợp này, tất cả người dùng giao diện người dùng cũ đều đăng nhập bằng thông tin xác thực cơ bản, trong đó thông tin xác thực của họ được lưu trữ trong cơ sở dữ liệu Edge OpenLDAP. Người dùng trải nghiệm Edge mới được đăng ký trong SAML IDP và đăng nhập bằng SAML.

    Tuy nhiên, người dùng giao diện người dùng cũ không thể đăng nhập vào trải nghiệm Edge mới cho đến khi bạn thêm người dùng đó vào IDP SAML như mô tả trong phần Đăng ký người dùng Edge mới.

Tệp cấu hình cài đặt

Tệp cấu hình chứa tất cả thông tin cần thiết để cài đặt và định cấu hình trải nghiệm Edge mới. Bạn có thể sử dụng cùng một tệp cấu hình để cài đặt và định cấu hình cả giao diện người dùng cơ sở và trải nghiệm Edge mới.

Dưới đây là ví dụ về tệp cấu hình:

# IP of the Edge Management Server. 
# This node also hosts the Edge SSO module and the current, or classic, Edge UI.
IP1=11.111.111.111

# IP of the New Edge experience node.
IP2=22.222.222.222 

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

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

# URLs for the different UIs.
# URL of classic Edge UI.
ROUTES_CLASSICUI="http://$IP1:9000"
# URL of New Edge experience.
ROUTES_SHOEHORN="http://$IP2:9000"

# New Edge experience configuration.
# Enable the New Edge experience.
EDGEUI_ENABLE_UNIFIED_UI=y
# Access port for the New Edge experience.
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=$IP2
# Disable TLS on the New Edge experience.
# This release does not support TLS.
MANAGEMENT_UI_USE_HTTPS=n

# SSO configuration for the New Edge experience.
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CLIENT_OVERWRITE=y
MANAGEMENT_UI_SSO_CLIENT_ID=newueclient
MANAGEMENT_UI_SSO_CLIENT_SECRET=secret111

# Location of New Edge experience.
MANAGEMENT_UI_PUBLIC_URIS=http://$IP2:3001
MANAGEMENT_UI_SSO_REGISTERED_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
MANAGEMENT_UI_SSO_CSRF_SECRET=secret222
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5

# Edge SSO configuration.
# Some settings are for the classic UI, 
# but are still required to configure the New Edge experience.
# Enable SSO.
EDGEUI_SSO_ENABLED=y

# Information about Classic UI
EDGEUI_PUBLIC_URIS=http://$IP1:9000
# Information about publicly accessible URL for Classic UI.
EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
# The name of the OAuth client used to connect to apigee-sso. 
# The default client name is edgeui.
# Apigee recommends that you use the same settings as you used
# when enabling SAML on the classic Edge UI.
EDGEUI_SSO_CLIENT_NAME=edgeui
# Oauth client password using uppercase, lowercase, number, and special chars. 
EDGEUI_SSO_CLIENT_SECRET=ssoClient123
# If set, existing EDGEUI client will deleted and new one will be created.
EDGEUI_SSO_CLIENT_OVERWRITE=y

# Information about Edge SSO module.
# Externally accessible IP or DNS of Edge SSO module.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on the Edge SSO module.
# If Edge SSO uses a self-signed cert, you must also set MANAGEMENT_UI_SKIP_VERIFY to "y".
# MANAGEMENT_UI_SKIP_VERIFY=y
SSO_PUBLIC_URL_SCHEME=http
# SSO admin credentials as set when you installed Edge SSO module.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=Secret123

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

Cài đặt giao diện người dùng Edge cơ bản (shoehorn)

Bạn phải cài đặt giao diện người dùng Edge cơ bản (gọi là shoehorn) trước khi có thể cài đặt trải nghiệm Edge mới.

Cách cài đặt giao diện người dùng cơ bản:

  1. Cài đặt phiên bản 4.18.01 của tiện ích apigee-setup trên nút như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.
  2. Dọn dẹp Yum: 
    > sudo yum clean all
  3. Tạo tệp cấu hình như mô tả ở trên và đảm bảo rằng tệp đó thuộc sở hữu của người dùng "apigee": 
    > chown apigee:apigee configFile

    trong đó configFile là tệp cấu hình được mô tả ở trên trong phần Tệp cấu hình cài đặt.

  4. Cài đặt phiên bản Shoehorn của giao diện người dùng Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui install
  5. Định cấu hình giao diện người dùng Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
  6. Bật SAML trên giao diện người dùng Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile

Cài đặt trải nghiệm Edge mới

Sau khi cài đặt giao diện người dùng Edge cơ bản, bạn có thể cài đặt và định cấu hình trải nghiệm Edge mới.

Cách cài đặt trải nghiệm Edge mới:

  1. Cài đặt trải nghiệm Edge mới: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
  2. Chuyển sang thư mục edge-management-ui: 
    > cd /opt/apigee/edge-management-ui
  3. Định cấu hình trải nghiệm Edge mới: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile

    trong đó configFile là tệp cấu hình được mô tả ở trên trong phần Tệp cấu hình cài đặt.

  4. Bật SAML trên trải nghiệm Edge mới: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
  5. Đăng nhập vào trải nghiệm Edge mới bằng cách mở URL sau trong trình duyệt: 
    http://newEdgeExperienceIP:3001

    trong đó newEdgeExperienceIP là địa chỉ IP của nút lưu trữ trải nghiệm Edge mới. Bạn sẽ được nhắc nhập thông tin đăng nhập SAML. Sau khi bạn nhập thông tin đăng nhập, trải nghiệm Edge mới sẽ xuất hiện.

  6. Hãy xem phần Trải nghiệm Edge mới cho Private Cloud (Thử nghiệm) để biết thêm thông tin, bao gồm cả các đường liên kết đến thông tin về cách sử dụng Trải nghiệm Edge mới.

Gỡ cài đặt trải nghiệm Edge mới

Cách gỡ cài đặt phiên bản Edge mới:

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

Cách gỡ cài đặt giao diện người dùng Edge cơ bản (shoehorn):

> /opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall

Cách xoá hoàn toàn Edge khỏi nút:

  1. Dừng tất cả dịch vụ Edge đang chạy trên máy: 
    > /opt/apigee/apigee-service/bin/apigee-all stop
  2. Xoá bộ nhớ đệm yum: 
    > sudo yum clean all
  3. Xoá tất cả RPM của Apigee: 
    > sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-|baas)")
  4. Xoá thư mục gốc cài đặt: 
    > sudo rm -rf /opt/apigee