設定新版 Edge UI

本文說明如何安裝及設定 Apigee Edge for Private Cloud 的新版 Edge UI。在 4.54.00 版中，新版 Edge UI 包含兩個 RPM 元件：

  • edge-management-ui：新版 Edge UI 後端伺服器。
  • edge-management-ui-static：新版 Edge UI 前端的靜態網頁資產。

當您使用 aio (多合一)、sa (獨立) 或 ms (管理伺服器) 設定檔執行 setup.sh 時，系統預設會安裝新版 Edge UI，您也可以使用 ue 設定檔在節點上獨立安裝。

必要條件

在 Apigee Edge for Private Cloud 安裝作業中安裝或設定新版 Edge UI 之前，請確認節點符合下列需求：

  • 硬體和 OS 需求：
    • 4 GB RAM
    • 2 個 CPU 核心
    • 60 GB 磁碟空間
    • 節點上安裝的 apigee-setup 公用程式 4.54.00 版，如「安裝 Edge apigee-setup 公用程式」一文所述。
    • 通訊埠 3001 必須開啟。這是預設通訊埠，用於向 New Edge UI 發出要求。如果您使用「新 Edge UI 設定檔」中所述的屬性變更通訊埠，請務必開啟該通訊埠。
  • 驗證：
    • 基本驗證 (預設)：預設為啟用 (AUTH_MODE=basic)。使用 Edge 管理伺服器和 SymasLDAP 憑證，不需要外部識別資訊提供者 (IDP)。
    • 單一登入 (SSO) / 外部 IDP (選用)：您可以選擇設定 Apigee SSO 或外部 IDP (例如 SAML 或 OIDC)。如果您透過 TLS 連線至外部 IdP，該 IdP 必須支援 TLS 1.2 以上版本。

如要進一步瞭解新版 Edge UI 功能，請參閱「Private Cloud 適用的新版 Edge UI」。

安裝和設定總覽

概略來說，使用 ue 設定檔安裝或重新設定 New Edge UI 的程序如下：

  • 確認節點上已安裝 apigee-setup 公用程式。
  • 建立無聲設定檔，並使用您的設定修改該檔案。
  • 執行 /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile。 這會安裝並設定 edge-management-ui 和 edge-management-ui-static。
  • 登入並在 http://new_edge_UI_IP:3001 測試新版 Edge 使用者介面。

如果管理伺服器和新版 Edge UI 伺服器位於負載平衡器後方，且負載平衡器會執行 TLS 卸載，請務必根據「 在負載平衡器終止 TLS 時設定新版 Edge UI」中醒目顯示的屬性進行設定。

新版 Edge 使用者介面設定檔

以下範例顯示設定檔，用於安裝及設定新版 Edge UI，並採用預設的基本驗證。

基本驗證設定 (預設)

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

如要使用 ue 設定檔安裝或設定新版 Edge UI，請按照下列步驟操作：

  1. 以管理員身分登入目標節點。
  2. 按照「安裝 Edge apigee-setup 公用程式」一文的說明，在節點上安裝 4.54.00 版的 apigee-setup 公用程式。
  3. 執行下列指令，使用 Yum 清除所有快取資訊： 
    sudo yum clean all
  4. 按照「新版 Edge UI 設定檔」一節所述建立設定檔，並確認該檔案的擁有者是「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 UI： 
    http://new_edge_UI_IP:3001

    其中 new_edge_UI_IP 是代管 New Edge UI 的節點 IP 位址或主機名稱。

  7. 輸入憑證。

    系統會顯示新版 Edge UI。如要瞭解如何使用新版 Edge UI，請參閱「Private Cloud 適用的新版 Edge UI」。

    如果未顯示新版 Edge UI，請確認通訊埠 3001 已開放連線。

選用：如要設定 Apigee 單一登入 (SSO) 服務進行驗證，請按照「安裝及設定 Apigee 單一登入 (SSO) 服務」和「在新版 Edge 使用者介面中啟用外部 IDP」中的步驟操作。

解除安裝新版 Edge UI

如要從節點解除安裝新版 Edge UI，請一併解除安裝 edge-management-ui 和 edge-management-ui-static 元件。

如要解除安裝新版 Edge UI 元件：

/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