Private Cloud v4.18.05 專用 Edge
本文說明如何安裝 Beta 版的 Edge 適用的新 Edge 服務 管理私有雲全新 Edge 體驗是新一代的 Edge UI。
如要試用 Edge for Private Cloud 中的 New Edge 服務,您必須:
- 在 Edge 上啟用 SAML。新版邊緣服務僅支援 SAML 驗證 以注意力機制為基礎
- 在專屬的節點中安裝 New Edge 體驗。您無法在 包含其他 Edge 元件
如要進一步瞭解 New Edge 體驗,請參閱 全新邊緣體驗 私有雲。
安裝總覽
如要安裝適用於 Private Cloud 的 New Edge 體驗 Beta 版,您必須 會執行兩種不同的安裝程序:
- 安裝基本 Edge UI (名為 shoehorn),然後設定基本 UI
用於使用 SAML 透過 Edge 進行驗證的 Edge UI。
- 安裝新版 Edge 服務,然後將 New Edge 體驗設為 使用 SAML 向 Edge 進行驗證安裝新版 Edge 服務後 以便與 Edge 搭配使用
安裝的必要條件
- 您必須先在 Edge 上啟用 SAML,才能安裝新版 Edge 服務。全新邊緣
體驗僅支援 SAML 做為驗證機制
如要瞭解如何在 Edge 上啟用 SAML,請參閱 支援 Edge for Private Cloud 的 SAML。
- 您必須在本身的節點上安裝新版 Edge 服務。無法安裝在節點上
包含其他 Edge 元件節點必須符合下列需求條件:
- JAVA 1.8 版
- 4 GB RAM
- 2 核心
- 60 GB 磁碟空間
- 您必須先在以下裝置上安裝 4.18.05 版本的
apigee-setup
公用程式 如 Install the Edge Apigee-setup 公用程式。
安裝新版 邊緣體驗
如上述先決條件所述,如要使用新版 Edge 服務,您必須啟用 SAML, 在 Edge 上也就是說,使用者驗證是由 SAML IDP 控管,您在設定 SAML 時 IDP:使用電子郵件地址做為使用者 ID。因此,所有 New Edge 體驗的使用者都必須處於部署狀態 向 SAML IDP 註冊。
Edge 傳統版 UI (您使用 Edge for Private Cloud 安裝的預設 UI) 不會 需要 SAML。可使用 SAML 或基本驗證。也就是說,您可以:
- 在 Edge 上以及傳統版 UI 和 New Edge 服務上啟用 SAML 支援。
在這種情況下,所有傳統版 UI 和 New Edge 服務的使用者都會向 SAML IDP 註冊。 如要瞭解如何將使用者新增至 SAML IDP,請參閱 註冊新的 Edge 使用者。
- 在 Edge 上啟用 SAML 支援,但保持啟用基本驗證。新版 Edge 體驗
SAML 和傳統版 UI 仍會使用基本驗證。
在此情況下,所有傳統版 UI 使用者都會以基本驗證憑證登入,其中 都會將憑證儲存在 Edge OpenLDAP 資料庫中。新 Edge 體驗的使用者 。
但是您必須新增傳統版 UI 使用者,才能登入新版 Edge 服務 使用者登入 SAML IDP,如註冊新的邊緣 使用者。
來自 Edge 4.18.01 的安裝設定變更
新版 Edge 4.18.05 版的 Edge 4.18.05 版包含下列變更: 更新設定檔這些屬性將詳細說明 在接下來的章節中:
變更類型 | 受影響的房源 |
---|---|
已新增 | # Shoehorn UI configurations. SHOEHORN_SCHEME SHOEHORN_IP SHOEHORN_PORT # Classic UI configurations. CLASSIC_UI_SCHEME CLASSIC_UI_IP CLASSIC_UI_PORT # Information about Edge SSO module. MANAGEMENT_UI_SKIP_VERIFY |
已移除 | ROUTES_SHOEHORN ROUTES_CLASSICUI |
已更換 | MANAGEMENT_UI_USE_HTTPS MANAGEMENT_UI_SCHEME |
安裝設定檔
設定檔包含安裝及設定新的 邊緣體驗您可以使用同一個設定檔來安裝及設定 使用者介面和全新邊緣體驗
以下是設定檔範例:
# 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 # # New Edge experience configuration. # # Enable the New Edge experience. EDGEUI_ENABLE_UNIFIED_UI=y # Specify IP and port for the New Edge experience. MANAGEMENT_UI_PORT=3001 MANAGEMENT_UI_IP=$IP2 # Specify a Private Cloud deployment. MANAGEMENT_UI_APP_ENV=OPDK # Disable TLS on the New Edge experience. # This release does not support TLS. MANAGEMENT_UI_SCHEME=http # 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 # 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 # # Shoehorn UI configuration. # # The first two properties use the same values as the New Edge experience. SHOEHORN_SCHEME=$MANAGEMENT_UI_SCHEME SHOEHORN_IP=$MANAGEMENT_UI_IP SHOEHORN_PORT=9000 # # Edge Classic UI configuration. # Some settings are for the classic UI, # but are still required to configure the New Edge experience. # # These settings assume that Classic UI is installed on the Management Server. CLASSIC_UI_IP=$MSIP CLASSIC_UI_PORT=9000 CLASSIC_UI_SCHEME=http EDGEUI_PUBLIC_URIS=$CLASSIC_UI_SCHEME://$CLASSIC_UI_IP:$CLASSIC_UI_PORT # Information about publicly accessible URL for Classic UI. EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS # Enable SSO. EDGEUI_SSO_ENABLED=y # 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". SSO_PUBLIC_URL_SCHEME=http # MANAGEMENT_UI_SKIP_VERIFY=y # 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"
安裝基本 Edge UI (shoehorn)
您必須先安裝名為 shoehorn 的基本 Edge UI,才能安裝新版 邊緣體驗
如何安裝基本 UI:
- 在節點上安裝 4.18.05 版的
apigee-setup
公用程式,做為: 詳情請參見安裝 Edge apigee-setup 公用程式 - Clean Yum:
sudo yum clean all
- 按照上述方式建立設定檔,並確保該設定檔由「apigee」擁有使用者:
chown apigee:apigee configFile
其中 configFile 是上述說明中的設定檔 安裝設定檔。
- 安裝 Shoehorn 版本的 Edge UI:
/opt/apigee/apigee-service/bin/apigee-service edge-ui install
- 設定 Edge UI:
/opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
- 在 Edge UI 上啟用 SAML:
/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
安裝新版 Edge 服務
安裝基本 Edge UI 後,即可安裝及設定新的 Edge 無須專人管理
如要安裝新版 Edge 服務,請按照下列步驟操作:
- 安裝新版 Edge 服務:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
- 切換至
edge-management-ui
目錄:cd /opt/apigee/edge-management-ui
- 設定全新邊緣體驗:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile
其中 configFile 是上述說明中的設定檔 安裝設定檔。
- 為 New Edge 體驗啟用 SAML:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
- 在瀏覽器中開啟下列網址,登入新版 Edge 服務:
http://newEdgeExperienceIP:3001
其中 newEdgeExperienceIP 是節點託管的 IP 位址 全新 Edge 體驗系統會提示您輸入 SAML 憑證。輸入 就會看到 New Edge 體驗。
- 請參閱 The New 私有雲 (Beta 版) 的邊緣體驗取得更多資訊,包括: 並瞭解如何使用新版邊緣服務
解除安裝新版 Edge 服務
如何解除安裝新版 Edge 服務:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
如何解除安裝基本 Edge UI (shoehorn):
/opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall
如要從節點完全移除 Edge:
- 停止電腦上執行的所有 Edge 服務:
/opt/apigee/apigee-service/bin/apigee-all stop
- 清除 Yum 快取:
sudo yum clean all
- 移除所有 Apigee RPM:
sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
- 移除安裝根目錄:
sudo rm -rf /opt/apigee