Định cấu hình giao diện người dùng mới của Edge

Tài liệu này mô tả cách cài đặt và định cấu hình Giao diện người dùng Edge mới cho Apigee Edge cho Đám mây riêng tư. Trong phiên bản 4.54.00, Giao diện người dùng Edge mới bao gồm 2 thành phần RPM:

  • edge-management-ui: Máy chủ phụ trợ của Giao diện người dùng Edge mới.
  • edge-management-ui-static: Thành phần web tĩnh cho giao diện người dùng Edge mới.

Giao diện người dùng Edge mới được cài đặt theo mặc định khi bạn chạy setup.sh bằng hồ sơ aio (tất cả trong một), sa (độc lập) hoặc ms (Máy chủ quản lý) hoặc có thể được cài đặt độc lập trên một nút bằng hồ sơ ue.

Điều kiện tiên quyết

Trước khi cài đặt hoặc định cấu hình Giao diện người dùng Edge mới trong quá trình cài đặt Apigee Edge cho Đám mây riêng tư, hãy đảm bảo nút đáp ứng các yêu cầu sau:

  • Yêu cầu về phần cứng và hệ điều hành:
    • RAM 4 GB
    • CPU 2 nhân
    • Dung lượng ổ đĩa 60 GB
    • Phiên bản 4.54.00 của tiện ích apigee-setup được cài đặt trên nút như mô tả trong bài viết Cài đặt tiện ích apigee-setup của Edge.
    • Cổng 3001 phải được mở. Đây là cổng mặc định dùng cho các yêu cầu đối với Giao diện người dùng Edge mới. Nếu bạn thay đổi cổng bằng cách sử dụng các thuộc tính được mô tả trong Tệp cấu hình Giao diện người dùng Edge mới, hãy đảm bảo rằng cổng đó được mở.
  • Xác thực:
    • Xác thực cơ bản (mặc định): Bật theo mặc định (AUTH_MODE=basic). Sử dụng thông tin đăng nhập của Máy chủ quản lý Edge và SymasLDAP mà không cần Nhà cung cấp dịch vụ nhận dạng (IDP) bên ngoài.
    • SSO / IDP bên ngoài (không bắt buộc): Bạn có thể tuỳ ý định cấu hình SSO Apigee hoặc IDP bên ngoài (chẳng hạn như SAML hoặc OIDC). Nếu bạn kết nối với một IDP bên ngoài qua TLS, thì IDP đó phải hỗ trợ TLS phiên bản 1.2 trở lên.

Để biết thêm thông tin về các tính năng của Giao diện người dùng Edge mới, hãy xem bài viết Giao diện người dùng Edge mới cho Đám mây riêng tư.

Tổng quan về quá trình cài đặt và định cấu hình

Ở cấp độ tổng quát, quy trình cài đặt hoặc định cấu hình lại Giao diện người dùng Edge mới bằng hồ sơ ue như sau:

  • Đảm bảo tiện ích apigee-setup được cài đặt trên nút.
  • Tạo tệp cấu hình im lặng và sửa đổi tệp đó bằng các chế độ cài đặt của bạn.
  • Chạy /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile. Thao tác này sẽ cài đặt và định cấu hình cả edge-management-ui và edge-management-ui-static.
  • Đăng nhập và kiểm thử Giao diện người dùng Edge mới tại http://new_edge_UI_IP:3001.

Nếu Máy chủ quản lý và máy chủ Giao diện người dùng Edge mới nằm sau một trình cân bằng tải có tính năng giảm tải TLS xảy ra tại trình cân bằng tải, hãy đảm bảo rằng cấu hình phản ánh các thuộc tính được nêu bật trong Định cấu hình Giao diện người dùng Edge mới khi TLS kết thúc trên trình cân bằng tải.

Tệp cấu hình Giao diện người dùng Edge mới

Ví dụ sau đây cho thấy một tệp cấu hình để cài đặt và định cấu hình Giao diện người dùng Edge mới bằng tính năng Xác thực cơ bản mặc định.

Cấu hình xác thực cơ bản (mặc định)

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

Cài đặt hoặc định cấu hình Giao diện người dùng Edge mới

Cách cài đặt hoặc định cấu hình Giao diện người dùng Edge mới bằng hồ sơ ue:

  1. Đăng nhập vào nút đích với tư cách quản trị viên.
  2. Cài đặt phiên bản 4.54.00 của tiện ích apigee-setup trên nút, như mô tả trong bài viết Cài đặt tiện ích apigee-setup của Edge.
  3. Xoá tất cả thông tin được lưu vào bộ nhớ đệm bằng Yum bằng cách chạy lệnh sau: 
    sudo yum clean all
  4. Tạo tệp cấu hình như mô tả trong Giao diện người dùng Edge mới và đảm bảo rằng tệp đó thuộc sở hữu của người dùng "apigee": 
    chown apigee:apigee configFile
  5. Trên nút, hãy chạy lệnh sau: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    Tiện ích apigee-setup sẽ cài đặt và định cấu hình edge-management-ui và edge-management-ui-static.

  6. Đăng nhập vào Giao diện người dùng Edge mới bằng cách mở URL sau trong trình duyệt: 
    http://new_edge_UI_IP:3001

    Trong đó, new_edge_UI_IP là địa chỉ IP hoặc tên máy chủ của nút lưu trữ Giao diện người dùng Edge mới.

  7. Nhập thông tin đăng nhập của bạn.

    Giao diện người dùng Edge mới sẽ xuất hiện. Để biết thông tin về cách sử dụng Giao diện người dùng Edge mới, hãy xem bài viết Giao diện người dùng Edge mới cho Đám mây riêng tư.

    Nếu Giao diện người dùng Edge mới không xuất hiện, hãy đảm bảo rằng cổng 3001 được mở cho các kết nối.

Không bắt buộc: Nếu bạn muốn định cấu hình SSO Apigee để xác thực, hãy làm theo các bước trong Cài đặt và định cấu hình SSO Apigee và Bật IDP bên ngoài trên Giao diện người dùng Edge mới.

Gỡ cài đặt Giao diện người dùng Edge mới

Để gỡ cài đặt Giao diện người dùng Edge mới khỏi một nút, hãy gỡ cài đặt cả edge-management-ui và edge-management-ui-static thành phần.

Cách gỡ cài đặt các thành phần của Giao diện người dùng Edge mới:

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

Cách xoá tất cả thành phầ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 Apigee: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. Xoá thư mục gốc cài đặt: 
    sudo rm -rf /opt/apigee